Cómo editar el cuerpo de tu webhook en una automatización

Ahora es posible personalizar el cuerpo del webhook en las Automatizaciones de CloudChat. Puedes construir el JSON en el formato que espera el sistema de destino, sin necesidad de usar una herramienta intermedia solo para convertir los datos.

Si dejas el cuerpo en blanco, CloudChat seguirá enviando el formato predeterminado.

Cómo configurar

Ve a Configuración > Automatizaciones y crea o edita una regla.
Elige el evento (por ejemplo, conversación creada o conversación actualizada) y las condiciones.
En Acciones, selecciona Enviar webhook y coloca la URL destino.
En el campo Cuerpo de la solicitud (JSON), escribe el JSON usando las variables a continuación.
Guarda.

Variables

Para atributos personalizados, reemplaza CLAVE por la clave del atributo como está registrada en CloudChat.

Contacto

- `{{ contact.id }}`: ID del contacto
- `{{ contact.name }}`: nombre completo
- `{{ contact.first_name }}`: primer nombre
- `{{ contact.last_name }}`: apellido
- `{{ contact.email }}`: correo electrónico
- `{{ contact.phone_number }}`: teléfono
- `{{ contact.custom_attribute.CLAVE }}`: atributo personalizado del contacto

Agente de la conversación

- `{{ agent.id }}`: ID del agente
- `{{ agent.name }}`: nombre
- `{{ agent.email }}`: correo electrónico

Conversación

- `{{ conversation.display_id }}`: número de la conversación que aparece en pantalla
- `{{ conversation.id }}`: ID interno de la conversación
- `{{ conversation.channel }}`: canal (ej.: `Channel::Whatsapp`)
- `{{ conversation.contact_name }}`: nombre del contacto
- `{{ conversation.custom_attribute.CLAVE }}`: atributo personalizado de la conversación
- `{{ conversation.assignee.name }}`: nombre del agente que el cliente ve
- `{{ conversation.assignee.first_name }}`: primer nombre del agente
- `{{ conversation.recent_messages }}`: últimos mensajes de la conversación

Bandeja de entrada y cuenta

- `{{ inbox.id }}`: ID de la bandeja de entrada
- `{{ inbox.name }}`: nombre de la bandeja de entrada
- `{{ account.id }}`: ID de la cuenta
- `{{ account.name }}`: nombre de la cuenta

Especificaciones

Siempre usa | json después de la variable. Esto coloca las comillas y trata acentos, comillas y saltos de línea. Si el campo está vacío, envía null.

Correcto: "nombre": {{ contact.name | json }}
Incorrecto: "nombre": "{{ contact.name }}"
Incorrecto: "nombre": {{ contact.name }}

Ejemplo:

{
  "email": {{ agent.email | json }},
  "ticket": {{ conversation.display_id | json }},
  "cliente": {{ contact.name | json }},
  "canal": {{ inbox.name | json }}
}