La plataforma para desarrolladores de Mercately, está creada para ayudar a todos nuestros clientes y empoderarlos para que crezcan mejor. Nuestras API están diseñadas para permitir que los equipos de cualquier forma o tamaño construyan integraciones y aprovechar al máximo Mercately. Todas las API de Mercately se construyen usando convenciones REST y están diseñadas para tener una estructura de URL predecible. U tilizan muchas funciones HTTP estándar, incluidos métodos (POST, GET, PUT, DELETE) y códigos de respuesta de error.
En Mercately, los agentes son conocidos como las personas que están en tu equipo de trabajo. Los agentes pueden estar atados a varios otros objetos como conversaciones, notas, tratos del embudo u órdenes. Este endpoint te devolverá datos necesarios del agente a ser usados en otros endpoints.
{- "agents": [
- {
- "id": 1,
- "first_name": "Agent",
- "last_name": "Example",
- "email": "agent@example.com",
- "active": true,
- "agent": false,
- "admin": true,
- "supervisor": false
}
]
}En Mercately, todo contacto proveniente de conversaciones, compras o creados directamente se clasifica como cliente. Este endpoint proporciona y permite la actualización de datos del cliente.
Obtén los datos de todos tus clientes
OK
Unauthorized
{- "results": 1,
- "total_pages": 1,
- "customers": [
- {
- "id": "28964696735",
- "first_name": "Adam",
- "last_name": "Smith",
- "email": "adam@smith.com",
- "phone": "",
- "meli_customer_id": null,
- "meli_nickname": null,
- "id_type": null,
- "id_number": "",
- "address": "Street 1",
- "city": "City",
- "state": "State",
- "zip_code": "59669",
- "country_id": "EC",
- "notes": "Customer notes",
- "whatsapp_opt_in": false,
- "whatsapp_name": "null",
- "tags": [
- {
- "tag": "Test tag",
- "web_id": "1713untwo79"
}
], - "custom_fields": [
- {
- "field_name": "rerum",
- "field_content:": "Test Field"
}
], - "agent": null,
- "creation_date": "2024-03-28T11:55:24.426-05:00"
}
]
}Crea un nuevo cliente
OK
Unauthorized
{- "first_name": "string",
- "last_name": "string",
- "email": "string",
- "phone": "string",
- "id_type": "cedula",
- "id_number": "string",
- "address": "string",
- "city": "string",
- "state": "string",
- "zip_code": "string",
- "notes": "string",
- "agent_id": 0,
- "tags": [
- {
- "name": "string",
- "value": true
}
], - "custom_fields": [
- {
- "field_name": "string",
- "field_content": "string"
}
], - "creation_date": "2019-08-24"
}{- "message": "Customer created successfully",
- "customer": {
- "id": "621fyxvm4696749",
- "first_name": "Juan",
- "last_name": "Campos",
- "email": "juan@email13.com",
- "phone": "",
- "meli_customer_id": null,
- "meli_nickname": null,
- "id_type": null,
- "id_number": null,
- "address": "Calle 5",
- "city": "Fort Worth",
- "state": "TX",
- "zip_code": "76106",
- "country_id": null,
- "notes": "New notes",
- "whatsapp_opt_in": false,
- "whatsapp_name": null,
- "tags": [
- {
- "tag": "prueba 1",
- "web_id": "621dysie44389"
}
], - "custom_fields": [
- {
- "field_name": "test",
- "field_content": "www.mercately.com"
}
], - "agent": {
- "id": 3321,
- "email": "Sam@gmail.com"
}, - "creation_date": "2024-03-28T11:55:24.426-05:00"
}
}Obtén los datos de un cliente en especifico buscado por ID
OK
Unauthorized
Not found
{- "message": "Customer found successfully",
- "customer": {
- "id": "6212983a216350",
- "first_name": "Jhomayra",
- "last_name": "Smith",
- "email": null,
- "phone": "+5196287234234",
- "meli_customer_id": null,
- "meli_nickname": null,
- "id_type": null,
- "address": "Street 1",
- "city": "City",
- "state": "State",
- "zip_code": "59669",
- "country_id": "EC",
- "notes": "Customer notes",
- "whatsapp_opt_in": true,
- "whatsapp_name": "Jhomayra Crispín Salvador",
- "tags": [
- {
- "tag": "Test tag",
- "web_id": "1713untwo79"
}
], - "custom_fields": [
- {
- "field_name": "rerum",
- "field_content:": "Test Field"
}
], - "agent": {
- "id": 2782,
- "email": "agent@gmail.com"
}, - "creation_date": "2024-03-28T11:55:24.426-05:00"
}
}Obtén los datos de un cliente en especifico buscado por email
OK
Unauthorized
Not found
{- "message": "Customer found successfully",
- "customer": {
- "id": "6212983a216350",
- "first_name": "Jhomayra",
- "last_name": "Smith",
- "email": null,
- "phone": "+5196287234234",
- "meli_customer_id": null,
- "meli_nickname": null,
- "id_type": null,
- "address": "Street 1",
- "city": "City",
- "state": "State",
- "zip_code": "59669",
- "country_id": "EC",
- "notes": "Customer notes",
- "whatsapp_opt_in": true,
- "whatsapp_name": "Jhomayra Crispín Salvador",
- "tags": [
- {
- "tag": "Test tag",
- "web_id": "1713untwo79"
}
], - "custom_fields": [
- {
- "field_name": "rerum",
- "field_content:": "Test Field"
}
], - "agent": {
- "id": 2782,
- "email": "agent@gmail.com"
}, - "creation_date": "2024-03-28T11:55:24.426-05:00"
}
}Obtén los datos de un cliente en especifico buscado por phone
OK
Unauthorized
Not found
{- "message": "Customer found successfully",
- "customer": {
- "id": "6212983a216350",
- "first_name": "Jhomayra",
- "last_name": "Smith",
- "email": null,
- "phone": "+5196287234234",
- "meli_customer_id": null,
- "meli_nickname": null,
- "id_type": null,
- "address": "Street 1",
- "city": "City",
- "state": "State",
- "zip_code": "59669",
- "country_id": "EC",
- "notes": "Customer notes",
- "whatsapp_opt_in": true,
- "whatsapp_name": "Jhomayra Crispín Salvador",
- "tags": [
- {
- "tag": "Test tag",
- "web_id": "1713untwo79"
}
], - "custom_fields": [
- {
- "field_name": "rerum",
- "field_content:": "Test Field"
}
], - "agent": {
- "id": 2782,
- "email": "agent@gmail.com"
}, - "creation_date": "2024-03-28T11:55:24.426-05:00"
}
}Actualiza un nuevo customer buscado por email, id o phone. Puedes realizar la busqueda igual que los métodos get
OK
Unauthorized
{- "first_name": "string",
- "last_name": "string",
- "email": "string",
- "phone": "string",
- "id_type": "cedula",
- "id_number": "string",
- "address": "string",
- "city": "string",
- "state": "string",
- "zip_code": "string",
- "notes": "string",
- "agent_id": 0,
- "tags": [
- {
- "name": "string",
- "value": true
}
], - "custom_fields": [
- {
- "field_name": "string",
- "field_content": "string"
}
], - "creation_date": "2019-08-24"
}{- "message": "Customer updated successfully",
- "customer": {
- "id": "621fyxvm4696749",
- "first_name": "Juan",
- "last_name": "Campos",
- "email": "juan@email13.com",
- "phone": "",
- "meli_customer_id": null,
- "meli_nickname": null,
- "id_type": null,
- "id_number": null,
- "address": "Calle 5",
- "city": "Fort Worth",
- "state": "TX",
- "zip_code": "76106",
- "country_id": null,
- "notes": "New notes",
- "whatsapp_opt_in": false,
- "whatsapp_name": null,
- "tags": [
- {
- "tag": "prueba 1",
- "web_id": "621dysie44389"
}
], - "custom_fields": [
- {
- "field_name": "test",
- "field_content": "www.mercately.com"
}
], - "agent": {
- "id": 3321,
- "email": "Sam@gmail.com"
}, - "creation_date": "2024-03-28T11:55:24.426-05:00"
}
}En Mercately, una vez vinculado con Messenger, este api permite realizar múltiples operaciones para acceder a las conversaciones de Messenger.
Obtén los clients que te han escrito por messenger
OK
Unauthorized
{- "page": 0,
- "results_per_page": 0,
- "unassigned": true
}{- "results": 155,
- "total_pages": 2,
- "messenger_conversations": [
- {
- "id": "621osgzy4696283",
- "first_name": "Claudia",
- "last_name": "Funnel",
- "email": null,
- "message_count": 3,
- "last_interaction": "2023-04-17T05:08:17.085Z",
- "agent_id": 4637
}
]
}En Mercately, una vez vinculado con WhatsApp, este api permite realizar múltiples operaciones para acceder a las conversaciones de WhatsApp y enviar mensajes.
Obtén los clients que te han escrito por whatsapp
OK
Unauthorized
{- "page": 0,
- "results_per_page": 0,
- "unassigned": true
}{- "results": 155,
- "total_pages": 2,
- "messenger_conversations": [
- {
- "id": "621osgzy4696283",
- "first_name": "Claudia",
- "last_name": "Funnel",
- "email": null,
- "message_count": 3,
- "last_interaction": "2023-04-17T05:08:17.085Z",
- "agent_id": 4637
}
]
}Obtén los templates/plantillas creadas en WhatsApp Business API
OK
Unauthorized
{ }{- "templates": [
- {
- "text": "Hola *! ✋",
- "status": "accepted",
- "template_type": "text",
- "internal_id": "c0c040f6-9809-404a-961c-637b109ef410"
}
]
}Para enviar un mensaje de WhatsApp cuando se tiene una conexión oficial al API de WhatsApp, sólo se requieren los parámetros phone_number, internal_id y template_params; los demás son opcionales. Si se tiene una conexión vía QR, por favor revisa la sección de envío de mensajes vía QR.
OK
Unauthorized
{- "phone_number": "string",
- "internal_id": "string",
- "template_params": [
- "string"
], - "media_url": "string",
- "first_name": "string",
- "last_name": "string",
- "email": "string",
- "address": "string",
- "city": "string",
- "state": "string",
- "zip_code": "string",
- "notes": "string",
- "agent_id": 0,
- "tags": [
- {
- "name": "string",
- "value": true
}
], - "custom_fields": [
- {
- "identifier": "string",
- "value": "string"
}
]
}{- "message": "Ok",
- "info": {
- "channel": "whatsapp",
- "content": {
- "text": "Hola Juan! ✋"
}, - "direction": "outbound",
- "status": "submitted",
- "destination": "+593999999999",
- "country": "EC",
- "created_time": "2022-09-23T16:34:16.768-04:00",
- "error": null
}
}Enviar un mensaje de WhatsApp cuando tienes una conexión oficial por QR. Los únicos parametros requeridos son phone_number y message, el resto de parámetros son opcionales.
OK
Unauthorized
{- "phone_number": "string",
- "message": "string",
- "media_url": "string",
- "first_name": "string",
- "last_name": "string",
- "email": "string",
- "address": "string",
- "city": "string",
- "state": "string",
- "zip_code": "string",
- "notes": "string",
- "agent_id": 0,
- "tags": [
- {
- "name": "string",
- "value": true
}
], - "custom_fields": [
- {
- "identifier": "string",
- "value": "string"
}
]
}{- "message": "Ok",
- "info": {
- "channel": "whatsapp",
- "content": {
- "text": "Hola Juan! ✋"
}, - "direction": "outbound",
- "status": "submitted",
- "destination": "+593999999999",
- "country": "EC",
- "created_time": "2022-09-23T16:34:16.768-04:00",
- "error": null
}
}Crea un nuevo evento para el cliente
CREATED
Unauthorized
{- "category": "string",
- "subcategory": "string",
- "type_event": "string",
- "action": "string",
- "source": "string",
- "url_spec": "string",
- "created_at": "string"
}{- "message": "Customer event created successfully"
}