TimelinesAI Blog

Customer.io: Invia messaggi WhatsApp automatizzati utilizzando l'API pubblica di TimelinesAI

Questo flusso di lavoro Customer.io: invia messaggi WhatsApp quando un utente compila un modulo web; verifica le risposte e invia messaggi aggiuntivi se non viene ricevuta alcuna risposta. Se viene ricevuta una risposta, il flusso di lavoro invia un messaggio di ringraziamento automatico. Il flusso si basa sull'API pubblica di TimelinesAI e sul flusso di lavoro Customer.io Journeys. Configurazione del trigger 1. Apri […]

January 18, 202412 min read
Customer.io: Invia messaggi WhatsApp automatizzati utilizzando l'API pubblica di TimelinesAI

Este flujo de trabajo de Customer.io: envía mensajes de WhatsApp cuando un usuario completa un formulario web; verifica las respuestas y realiza un seguimiento con mensajes adicionales si no se recibe respuesta. Si se recibe una respuesta, el flujo de trabajo envía un mensaje de agradecimiento automático. El flujo se basa en API Pública de TimelinesAI y flujo de trabajo Customer.io Journeys.

Configuración del disparador

1. Abre tu cuenta de Customer.io > Campañas
2. Crea una campaña: asigna el nombre deseado, descripción y etiquetas
3. Selecciona el disparador deseado. En este ejemplo, usaremos el disparador Cuando alguien envía un formulario
4. Configura tu formulario. Este flujo de trabajo requiere un formulario con varios campos ocultos. Por favor, verifica con el proveedor del formulario si se pueden agregar tales campos. Los nombres de los campos ocultos deben tener los valores listados a continuación y los valores deben dejarse vacíos. Los valores para esos campos se agregarán automáticamente en pasos posteriores del flujo de trabajo.

Nombres de campos ocultos requeridos:

  • message_1
  • message_2
  • chatid
  • message1_timestamp
  • message2_timestamp
  • last_message_timestamp
  • last_message_timestamp_2

Campo estándar requerido:

  • campo para el número de teléfono que el usuario completa dentro del formulario.

5. Selecciona la configuración deseada en Configuración y Objetivo y Salida

6. Guarda tu campaña y completa tu formulario para obtener los datos iniciales para los pasos siguientes del flujo de trabajo. Cuando se envía el formulario, un nuevo contacto debe aparecer en Customer.io > Personas. El contacto creado tendrá los datos del formulario como atributos. Los campos ocultos resultarán en atributos con xxxxx como valor.

Envío del primer mensaje automático de WhatsApp en respuesta al formulario completado

El propósito de este paso es enviar automáticamente el primer mensaje de WhatsApp cuando el cliente completa el formulario

1. Reabre tu campaña en Customer.io y navega a la pestaña Flujos de trabajo.
2. Arrastra y suelta Enviar y recibir datos al tablero de flujo de trabajo (colócalo después del disparador). Haz clic en el módulo “Webhooks” recién colocado para configurarlo.

3. Configura el módulo:

  • NOMBRE DEL WEBHOOK – renombra el módulo a Enviar primer mensaje WA
  • COMPORTAMIENTO DEL ENVÍO – selecciona enviar automáticamente
  • otras configuraciones – selecciona según sea necesario

4. Agrega una solicitud:

{
"phone": "YOUR_DATA_HERE",
"whatsapp_account_phone": "+YOUR_WA_SENDER_NUMBER_HERE",
"text": "YOUR_CUSTOM_MESSAGE_HERE"
}

  • YOUR_WA_SENDER_NUMBER_HERE – debe contener tu número de cuenta de WhatsApp en formato internacional
  • YOUR_CUSTOM_MESSAGE_HERE – el mensaje deseado
  • YOUR_DATA_HERE – debe contener el número de teléfono que la persona ingresó al completar tu formulario. Para agregar datos personalizados, primero borra el texto YOUR_DATA_HERE, deja el cursor entre ” ” y abre los datos de ejemplo de la barra lateral izquierda > pestaña Event Data > desplázate hacia abajo para encontrar el campo del formulario que contiene un número de teléfono > haz clic en el + al lado > selecciona El mensaje o la acción fallará en un elemento emergente > haz clic en agregar. Tu solicitud cambiará a algo como: “phone”: “{{event.nLJpTuNCaZrs}}”
  • Respuesta – cambia a la pestaña Respuesta > Configura un atributo > selecciona message_1 bajo el menú desplegable Establecer > agrega {{response.data.message_uid}} en el cuadro de solicitud

5. Después de que se agreguen la solicitud y la respuesta, haz clic en el botón Enviar prueba en la esquina superior derecha de la página. Deberías obtener el estado de respuesta 200 OK y un mensaje de éxito para establecer el atributo:

Obtención de datos sobre el ID de chat de TimelinesAI y la marca de tiempo del mensaje enviado

El propósito de este paso es obtener el ID de chat y la marca de tiempo del mensaje inicial de WhatsApp. Esta información es esencial para determinar si el cliente respondió al primer mensaje más adelante

1. Reabre tu campaña en Customer.io y navega a la pestaña Flujos de trabajo.
2. Arrastra y suelta Enviar y recibir datos al tablero de flujo de trabajo (colócalo después del módulo Enviar primer mensaje WA). Haz clic en el módulo “Webhooks” recién colocado para configurarlo.
3. Configura el módulo:

  • NOMBRE DEL WEBHOOK – renombra el módulo a Obtener ID de chat y marca de tiempo del primer mensaje
  • COMPORTAMIENTO DEL ENVÍO – selecciona enviar automáticamente
  • otras configuraciones – selecciona según sea necesario

4. Agrega una solicitud:

  • Tipo: GET
  • URL: https://app.timelines.ai/integrations/api/messages/{{customer.message_1}}
  • Encabezado1: nombre = Content-Type, valor = application/json
  • Encabezado2: nombre = Autorización, valor = Bearer XXX. Donde XXX debe reemplazarse con tu token de TimelinesAI de https://app.timelines.ai/integrations/api/
  • Respuesta: cambia a la pestaña Respuesta > Configura un atributo > selecciona chatid bajo el menú desplegable Establecer > agrega {{response.data.chat_id}} en el cuadro de solicitud. Luego haz clic en Establecer otro atributo. Selecciona message1_timestamp bajo el menú desplegable Establecer > agrega {{response.data.timestamp}} en el cuadro de solicitud

5. Después de que se agreguen la solicitud y la respuesta, haz clic en el botón Enviar prueba. Deberías obtener el estado de respuesta 200 OK y un mensaje de éxito para establecer el atributo
6. Arrastra y suelta Retraso de tiempo al tablero de flujo de trabajo (colócalo después del módulo Obtener ID de chat y marca de tiempo del primer mensaje). Selecciona la cantidad de tiempo deseada que te gustaría que el flujo permanezca en espera antes de continuar. Ejemplo: 1 hora
7. Arrastra y suelta Enviar y recibir datos al tablero de flujo de trabajo (colócalo después del módulo Retraso de tiempo). Haz clic en el módulo “Webhooks” recién colocado para configurarlo.
8. Configura el módulo:

  • NOMBRE DEL WEBHOOK – renombra el módulo a Verificar ID de chat
  • COMPORTAMIENTO DEL ENVÍO – selecciona enviar automáticamente
  • otras configuraciones – selecciona según sea necesario

9. Agrega una solicitud:

10. Después de que se agreguen la solicitud y la respuesta, haz clic en el botón Enviar prueba. Deberías obtener el estado de respuesta 200 OK y un mensaje de éxito para establecer el atributo

Resultados intermedios:

Verificación de si el primer mensaje de WhatsApp recibió una respuesta o no. Envío de un mensaje de “Gracias” si se recibió la respuesta.

  1. Arrastra y suelta la rama Verdadero/Falso al tablero de flujo de trabajo (colócala después del módulo Verificar ID de chat).
  • Nombre: para evitar confusión, recomendamos dar el siguiente nombre a este módulo: VERDADERO = sin respuesta. ¿El cliente respondió al primer mensaje?
  • Condiciones: selecciona lastmessagetimestamp en el primer menú desplegable; es igual a en el segundo menú desplegable; atributo de la persona actual en el tercer menú desplegable; message1_timestamp en el cuarto menú desplegable:

Nuestro flujo de trabajo ahora se divide en dos ramas: “Verdadero” indica que el cliente no respondió al mensaje inicial de WhatsApp, mientras que “Falso” indica que el cliente respondió.

Es crucial considerar que determinar si un cliente ha respondido implica comparar dos marcas de tiempo: la marca de tiempo del mensaje inicial de WhatsApp y la marca de tiempo del último mensaje en el chat. Si estas marcas de tiempo son idénticas, indica que no han aparecido nuevos mensajes en el chat, lo que sugiere directamente que el usuario no respondió al primer mensaje. Por el contrario, si las marcas de tiempo no coinciden, implica que había nuevos mensajes en el chat después del primer mensaje de WhatsApp enviado. Si bien esto sugiere fuertemente una respuesta, no es una garantía absoluta, ya que es concebible que, dentro del período de espera de una hora entre el primer mensaje y el momento actual, hayas enviado otro mensaje al usuario, alterando la marca de tiempo del último mensaje.

Terminemos primero la rama “Falso”:

2. Arrastra y suelta Enviar y recibir datos al tablero de flujo de trabajo (colócalo bajo la rama Falso). Haz clic en el módulo “Webhooks” recién colocado para configurarlo.
3. Configura el módulo:

  • NOMBRE DEL WEBHOOK – asigna al módulo cualquier nombre. Ejemplo: Enviar mensaje de agradecimiento
  • COMPORTAMIENTO DEL ENVÍO – selecciona enviar automáticamente
  • otras configuraciones – selecciona según sea necesario

4. Agrega una solicitud:

{
"text": "YOUR_CUSTOM_MESSAGE_HERE"

}

  • YOUR_CUSTOM_MESSAGE_HERE – el mensaje deseado

5. Arrastra y suelta el módulo Salida al flujo de trabajo

Envío del segundo mensaje automático de WhatsApp si no se recibió respuesta para el primero

1. Arrastra y suelta Enviar y recibir datos al tablero de flujo de trabajo (colócalo bajo la rama Verdadero). Haz clic en el módulo “Webhooks” recién colocado para configurarlo.
2. Configura el módulo:

  • NOMBRE DEL WEBHOOK – nombra el módulo Enviar segundo mensaje WA
  • COMPORTAMIENTO DEL ENVÍO – selecciona enviar automáticamente
  • otras configuraciones – selecciona según sea necesario

3. Agrega una solicitud:

{
"text": "YOUR_CUSTOM_MESSAGE_HERE"

}

  • YOUR_CUSTOM_MESSAGE_HERE – el mensaje deseado
  • Respuesta: cambia a la pestaña Respuesta > configura un atributo > selecciona message_2 bajo el menú desplegable Establecer > agrega {{response.data.message_uid}} en el cuadro de solicitud.

5. Después de que se agreguen la solicitud y la respuesta, haz clic en el botón Enviar prueba en la esquina superior derecha de la página. Deberías obtener el estado de respuesta 200 OK y un mensaje de éxito para establecer el atributo
6. Arrastra y suelta Enviar y recibir datos al tablero de flujo de trabajo (colócalo después del módulo Enviar primer mensaje WA). Haz clic en el módulo “Webhooks” recién colocado para configurarlo.
7. Configura el módulo:

  • NOMBRE DEL WEBHOOK – renombra el módulo a Obtener marca de tiempo del segundo mensaje
  • COMPORTAMIENTO DEL ENVÍO – selecciona enviar automáticamente
  • otras configuraciones – selecciona según sea necesario

Agrega una solicitud:

9. Después de que se agreguen la solicitud y la respuesta, haz clic en el botón Enviar prueba. Deberías obtener el estado de respuesta 200 OK y un mensaje de éxito para establecer el atributo

10. Arrastra y suelta Retraso de tiempo al tablero de flujo de trabajo (colócalo después del módulo Obtener marca de tiempo del segundo mensaje). Selecciona la cantidad de tiempo deseada que te gustaría que el flujo permanezca en espera antes de continuar. Ejemplo: 1 hora
11. Arrastra y suelta Enviar y recibir datos al tablero de flujo de trabajo (colócalo después del módulo Retraso de tiempo). Haz clic en el módulo “Webhooks” recién colocado para configurarlo.
12. Configura el módulo:

  • NOMBRE DEL WEBHOOK – renombra el módulo a Verificar ID de chat
  • COMPORTAMIENTO DEL ENVÍO – selecciona enviar automáticamente
  • otras configuraciones – selecciona según sea necesario

13. Agrega una solicitud:

10. Después de que se agreguen la solicitud y la respuesta, haz clic en el botón Enviar prueba en la esquina superior derecha de la página. Deberías obtener el estado de respuesta 200 OK y un mensaje de éxito para establecer el atributo

Verificación de si el segundo mensaje de WhatsApp recibió una respuesta

1. Arrastra y suelta la rama Verdadero/Falso al tablero de flujo de trabajo (colócala después del módulo Verificar ID de chat).

  • Nombre: para evitar confusión, recomendamos dar el siguiente nombre a este módulo: VERDADERO = sin respuesta. ¿El cliente respondió al segundo mensaje?
  • Condiciones: selecciona last_message_timestamp_2 en el primer menú desplegable; es igual a en el segundo menú desplegable; atributo de la persona actual en el tercer menú desplegable; message2_timestamp en el cuarto menú desplegable:

Ahora nuestro flujo de trabajo se divide en 2 ramas nuevamente donde “Verdadero” = el cliente NO respondió al segundo mensaje de WhatsApp y “Falso” = el cliente respondió.

2. Arrastra y suelta Enviar y recibir datos al tablero de flujo de trabajo (colócalo bajo la rama Falso). Cuando se coloca, creará un nuevo bloque llamado “Webhooks” por defecto.
3. Configura el módulo:

  • NOMBRE DEL WEBHOOK – asigna al módulo cualquier nombre. Ejemplo: Enviar mensaje de agradecimiento
  • COMPORTAMIENTO DEL ENVÍO – selecciona enviar automáticamente
  • otras configuraciones – selecciona según sea necesario

4. Agrega una solicitud:

{
"text": "YOUR_CUSTOM_MESSAGE_HERE"

}

5. Arrastra y suelta el módulo Salida al flujo de trabajo
6. Arrastra y suelta el módulo Salida al flujo de trabajo bajo la rama Verdadero

Resultado final: el usuario completa el formulario, el flujo de trabajo envía automáticamente el primer mensaje de WhatsApp en respuesta al formulario completado > verifica si el usuario respondió al primer mensaje. Si es así > envía un mensaje de agradecimiento en respuesta y sale del flujo. Si el usuario no respondió al primer mensaje: envía el segundo mensaje de WhatsApp > verifica si el usuario respondió al segundo mensaje. Si es así > envía un mensaje de agradecimiento en respuesta y sale del flujo. Si el usuario no respondió al segundo mensaje > sale del flujo. Descarga la imagen del flujo de trabajo completo aquí: https://storage.crisp.chat/users/helpdesk/website/94268256ba492800/customerio-workflow-sending-wa_k4393j.png