📥
API de Contactos
Le permite agregar, editar y recuperar información de contacto a través de API.
La API 1.0 de Contactos y Mensajes quedará obsoleta en 2023. Le recomendamos encarecidamente que empiece a migrar a la nueva API pronto.
Comience a construir con la API de la próxima generación de okeybot.com. Consulte nuestra documentación específica sobre la API.
Las llamadas a la API se realizan por canal. Los tokens se pueden generar usando el icono de llave, junto al canal deseado en Configuración . Hay un límite de frecuencia de 100 llamadas API por minuto.
La API de contactos se compone de varias solicitudes:
Esta solicitud devuelve una lista de objetos de contacto con paginación.
/v1/contact/by_custom_field
Si desea recuperar una lista de contactos por campo personalizado de tipo booleano, asegúrese de utilizar TRUE o FALSE como valor.
curl -X GET \
'https://app.okeybot.com/api/v1/contact/by_custom_field?name=firstName&value=Muhammad%20Mahin' \
-H 'Authorization: Bearer {channel_token}' \
-H 'Content-Type: application/json'
{
"data": [
{
"id": "1776025372480910",
"custom_fields": {
"firstName": "Mahin",
"lastName": "Dar",
"locale": "en_GB",
"timezone": "5",
"gender": "male",
"phone": "123123",
"email": "[email protected]",
"customerid": "1"
},
"tags": [
"Blog Updates",
"Platform Updates"
],
"created_at": 1575618542
}
],
"links": {
"first": "http://app.okeybot.com/api/v1/contact/by_custom_field?page=1",
"last": "http://app.okeybot.com/api/v1/contact/by_custom_field?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"path": "http://app.okeybot.com/api/v1/contact/by_custom_field",
"per_page": 10,
"to": 1,
"total": 1
}
}
Esta solicitud devuelve un único objeto de contacto.
/v1/contact/{contact_id}
curl -X GET \
https://app.okeybot.com/api/v1/contact/1776025372480910 \
-H 'Authorization: Bearer {channel_token}' \
-H 'Content-Type: application/json' \
{
"data": {
"id": "1776025372480910",
"custom_fields": {
"firstName": "Mahin",
"lastName": "Dar",
"locale": "en_GB",
"timezone": "5",
"gender": "male",
"phone": "123123",
"email": "[email protected]",
"customerid": "1"
},
"tags": [
"Blog Updates",
"Platform Updates"
],
"created_at": 1575618542
}
}
Esta solicitud actualiza un valor de campo personalizado de contacto.
/v1/contact/{contact_id}
curl -X PUT \
https://app.okeybot.com/api/v1/contact/1776025372480910 \
-H 'Authorization: Bearer {channel_token}' \
-H 'Content-Type: application/json' \
-d '{
"custom_fields": [
{
"name": "firstName",
"value": "Muhammad Mahin"
},
{
"name": "lastName",
"value": "Dar"
}
]
}'
{
"data": {
"id": "cus_112233344555"
}
}
Máximo 30 campos actualizados por solicitud.
Tenga en cuenta que en el caso del canal Viber, debido a una cierta limitación, la ID de contacto debe proporcionarse en un formato codificado en Base64 .
Esta solicitud agrega etiquetas para un contacto.
/v1/contact/{contact_id}/tags
curl -X POST \
https://app.okeybot.com/api/v1/contact/1776025372480910/tags \
-H 'Authorization: Bearer {channel_token}' \
-H 'Content-Type: application/json' \
-d '{
"tags": [
"Blog Updates",
"Platform Updates"
]
}'
{
"status": "success",
"message": "Contact Tags have been added successfully.",
"data": []
}
Máximo 10 etiquetas agregadas por solicitud.
Esta solicitud elimina las etiquetas de un contacto.
/v1/contact/{contact_id}/tags
curl -X DELETE \
https://app.okeybot.com/api/v1/contact/1776025372480910/tags \
-H 'Authorization: Bearer {channel_token}' \
-H 'Content-Type: application/json' \
-d '{
"tags": [
"Blog Updates",
"Platform Updates"
]
}'
{
"status": "success",
"message": "Contact Tags deleted successfully.",
"data": []
}
Máximo de 10 etiquetas eliminadas por solicitud.
Tenga en cuenta que en el caso del canal Viber, debido a una cierta limitación, la ID de contacto debe proporcionarse en un formato codificado en Base64.
Esta solicitud crea un contacto y establece valores para sus campos personalizados.
/v1/contact
curl -X POST \
https://app.okeybot.com/api/v1/contact/ \
-H 'Authorization: Bearer {channel_api_token}' \
-H 'Content-Type: application/json' \
-d '{
"custom_fields": [
{
"name": "phone",
"value": "03244077087"
},
{
"name": "firstName",
"value": "Muhammad Mahin"
},
{
"name": "lastName",
"value": "Dar"
}
]
}'
{
"data": {
"id": "cus_112233344555"
}
}
{
"status": "error",
"message": "API Token is invalid.",
"data": []
}
{
"status": "error",
"message": "Too many requests",
"data": []
}
{
"status": "error",
"message": "405 Method Not Allowed.",
"data": []
}
{
"status": "error",
"message": "Message String",
"data": []
}
Máximo 30 campos creados por solicitud.
Última actualización 5mo ago