Usar Webhook de Mensajes Recibidos en el inbox: Notificaciones para sistemas externos

Usar Webhook de Mensajes Recibidos en el inbox: Notificaciones para sistemas externos

Usuarios autorizados: Administradores.
La misión: Recibe los mensajes entrantes de Inbox en tu sistema externo.

 Importante: Si tu sistema externo necesita enviar mensajes por WhatsApp, Facebook o Instagram, consulta la documentación sobre el Envío de Mensajes por API Pública.

​​
Los webhooks de Escala permiten suscribirse a eventos específicos, recibiendo notificaciones en tiempo real en una URL externa que configures. Esto es fundamental para integrar la actividad de tu inbox con sistemas externos y automatizar procesos avanzados.

¿Qué es un Webhook de Mensajes Recibidos y para qué sirve?

Un webhook para mensajes recibidos es una suscripción que notifica a un sistema externo cada vez que llega un mensaje al inbox de Escala. Al activarlo, Escala enviará una notificación con el contenido completo (proveniente de WhatsApp, Facebook o Instagram) del mensaje a la URL que especifiques.

Este webhook es útil porque:
  1. Permite que tu Inbox de Escala se conecte e interactúe con otros sistemas externos (plataformas o desarrollos personalizados).
  2. Al recibir todos los detalles del mensaje entrante, tu sistema externo puede analizar, procesar y reaccionar al contenido de forma programática.

Configuración del Webhook de Mensajes Recibidos

Para activar este webhook y especificar dónde se enviarán las notificaciones:

1. Dirígete a Perfil y configuraciones > CRM.
2. Busca la sección de Webhooks.
3. Activa el interruptor para Activar webhooks para mensajes recibidos en el Inbox.
4. Luego, define e ingresa la URL a la que Escala debe enviar la notificación cada vez que se reciba un mensaje. Esta URL debe ser un punto de recepción configurado en tu sistema externo y debe ser válida.
5. Por último, haz clic en Guardar tu configuración.



Contenido de la notificación del Webhook

Cuando Escala envía una notificación por un mensaje recibido, esta incluye información detallada del evento y del mensaje:
  1. Detalles del mensaje: El cuerpo del mensaje de texto o los datos específicos si es otro tipo de contenido (ej. audio, imagen, video, documento, sticker).
  2. Información del remitente: El número de teléfono (para WhatsApp) o el handler/nombre de usuario (para Facebook/Instagram DM).
  3. Canal de origen: El canal por el cual se recibió el mensaje (WhatsApp, Facebook, Instagram).
  4. Contexto de la conversación: Incluye el ID de la cuenta conectada (accountId), el ID de la conversación (conversationId), y el Front (número de teléfono o identificador de Messenger/Instagram).
  5. Origen del evento: El Source indica que el evento viene del Inbox.
  6. Tipo de interacción: El Interaction Type siempre indicará customer para mensajes recibidos.
  7. Información de anuncios: Si el mensaje llegó a través de un anuncio, se incluirán datos de referencia.

Casos de uso del Webhook de Mensajes Recibidos 

  1. Integración con Agentes de IA externos: Conecta el Inbox de Escala con un agente de inteligencia artificial externo. El webhook notifica a tu sistema externo cuando llega un mensaje, y ese sistema lo procesa para generar una respuesta.
  2. Activación de procesos externos: Utiliza la notificación del webhook para activar cualquier proceso o acción en un sistema externo, como enviar un SMS de alerta o registrar el evento en un canal de comunicación interno.
  3. Análisis de datos personalizados: Envía los datos de los mensajes a tu propio sistema de análisis para obtener insights específicos no cubiertos por los reportes de Escala.

 Importante: La implementación y el procesamiento de estas notificaciones en el sistema externo requieren conocimientos técnicos de desarrollo.



¿Estás listo para completar la misión en Escala?

Completar ahora