• Esta función se encuentra actualmente en Beta. Si tiene algún problema, contáctenos aquí .

Sugerencias: también le brindamos un ejemplo de canal personalizado que puede intentar implementar en su servidor. Por favor, eche un vistazo a nuestro proyecto GitHub

Cómo funciona #

Para recibir un mensaje a través de un canal personalizado, se deben seguir los siguientes pasos:

1. 1.Cuando un contacto intenta enviar un mensaje, el proveedor de servicios de mensajería llamará a su servidor de integración personalizado con la carga útil del mensaje (consulte la documentación de la API del proveedor de servicios de mensajería como referencia).
2. 2.Su servidor de integración personalizado recibirá el mensaje y lo publicará en chatiico.com (en formato chatiico.com ).
3. 3.​ chatiico.com recibirá la solicitud de publicación, guardará el mensaje y lo mostrará en el módulo de mensajería.

Enviando un mensaje: #

Para enviar un mensaje a través de un canal personalizado, se deben seguir los siguientes pasos:

1. 1.Cuando un Usuario/Flujo de trabajo/Difusión intente enviar un mensaje, chatiico.com llamará a su servidor de integración personalizado con la carga útil del mensaje (en formato chatiico.com ).
2. 2.Su servidor de integración personalizado recibirá el mensaje y lo publicará en el proveedor de servicios de mensajería en el formato que requiera (consulte la documentación de la API del proveedor de servicios de mensajería como referencia).
3. 3.El proveedor de servicios de mensajería recibirá el Webhook y confirmará si el mensaje se entregó correctamente. Sugerencias, si el mensaje no se entrega correctamente, puede intentar agregar un mecanismo de reintento en su servidor de integración personalizado.

Configuración #

Paso 1: Crea un canal #

1. En la plataforma¿chatiico.com, vaya a Configuración > Canales y haga clic en el botón ADD CHANNEL
2. Seleccionar canal personalizado
3. Introducir elAPI Base URL
4. Seleccione el para el canal y haga clic en SIGUIENTE. Este ID tiene como finalidad la identificación del usuario y se utilizará para comunicarse con su servidor de integración personalizado. Hay dos tipos de identificaciones disponibles: ID type

1. 1.Número de teléfono : use esto si el proveedor de servicios de mensajería reconoce los contactos en función de su número de teléfono .Formato de muestra:+60177872890
2. 2.ID personalizado : use esto si el proveedor de servicios de mensajería reconoce los contactos en función de un ID generado de forma personalizada.
   1. La longitud máxima de caracteres es 50
   2. A-Z, a-z, 0-9, _, =, +y están permitidos /.@

5.El siguiente cuadro de diálogo proporcionará , y, por ejemplo ,Channel ID API Token Webhook URL

1. Canal ID:gfd8g7fd89dgfd
2. Fichas API:aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd
3. URL del webhook:https://app.chatiico.com/custom/webhook

Sugerencias: el uso del tipo de identificación del número de teléfono le permite iniciar una conversación y enviar el primer mensaje a un contacto.

Paso 2: Pasar mensajes a chatiico.com #

La URL del webhook se usa para publicar el MessagesMessaging EchoesMessaging Receipts

El siguiente código llamará al webhook en la plataforma chatiico.com y creará el contacto (si no existe) y guardará el mensaje en el contacto.

curl -X POST \
**<https://app.chatiico.com/custom/webhook**> \
-H ‘authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd’ \
-H ‘cache-control: no-cache’ \
-H ‘content-type: application/json’ \
-d ‘{
“channelId”: “gfd8g7fd89dgfd”,
“contactId”: “+60177872890”,
“events”: [
{
“type”: “message”,
“mId”: “xcvzzxcxczxczxc”,
“timestamp”: 2132131321000,
“message”: {
“type”: “text”,
“text”: “Hello World”
}
}
],
“contact”: {
“firstName”: “John”,
“lastName”: “Doe”,
“profilePic”: “https://static.independent.co.uk/s3fs-public/thumbnails/image/2015/07/08/14/pic.jpg“,
“countryCode”: “MY”,
“email”: “ventas@chatiico.com”,
“phone”: “+60177872890”,
“language”: “en”
}
}’

Campos

Paso 3: Manejar los mensajes salientes de chatiico.com #

Chatiico.com llamará al siguiente punto final<API Base URL>/message

• Importante: asegúrese de implementar el código de mensaje saliente en la ruta en su servidor web/message

Aquí está el ejemplo cURL de chatiico llamando al punto final

curl -X POST \
<API Base URL>/message \
-H ‘authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd’ \
-H ‘cache-control: no-cache’ \
-H ‘content-type: application/json’ \
-d ‘{
“channelId”: “gfd8g7fd89dgfd”,
“contactId”: “+60177872890”,
“message”: {
“type”: “text”,
“text”: “Hello World”
}
}’

Respuesta – Éxito (estado HTTP → 200) #

{
“mId”: “1640141607842”
}

La autenticación debe realizarse en el punto final antes de pasar el mensaje al proveedor de servicios de mensajería. Aquí hay un ejemplo de middleware express

};

module.exports = {
validateToken
};

Tipo de mensajes #

#

{
“type”: “text”,
“text”: “Welcome to chatiico”,
}

Sugerencias: también le brindamos un ejemplo de canal personalizado que puede intentar implementar en su servidor. Por favor, eche un vistazo a nuestro proyecto GitHub

Muestra de texto #

{
“type”: “text”,
“text”: “Welcome to chatiico.com”,
}

Campos

Muestra para archivo multimedia #

{
“type”: “attachment”,
“attachment”: {
“type”: “image|video|audio|file”,
“url”: “https://abc/japan.png”,
“mimeType”: “image/png”,
“fileName”:”company logo.png”,
“description”: “latest company logo”
}
}

Muestra para la ubicación

{
“type”: “location”,
“latitude”: 0.123456,
“longitude”: -0.1234,
“address”: “Sky Suites, Jalan P. Ramlee, Kuala Lumpur, 50250 Kuala Lumpur, Wilayah Persekutuan Kuala Lumpur”
}

Sample for Quick Reply

{
“type”: “quick_reply”,
“title”: “Select your preferred language”,
“replies”: [
“Malay”,
“English”
]
}

Solucionar problemas

Esta función se encuentra actualmente en Beta. Si tiene algún problema, contáctenos