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

    • Related Articles

    • Envío de mensajes por API Pública: Automatiza comunicaciones desde sistemas externos

      Usuarios autorizados: Administradores. La misión: Envía mensajes de WhatsApp, Facebook e Instagram desde tu sistema externo. Importante: Si tu sistema externo necesita recibir notificaciones de mensajes entrantes del Inbox de Escala, consulta la ...

    • Funcionamiento de las notificaciones del inbox en Escala

      Usuarios autorizados: Administradores y vendedores. La misión: Conoce cómo funcionan las notificaciones de tus mensajes de WhatsApp en Escala. En Escala, las notificaciones de mensajes vía inbox solo se envían al dueño de la conversación. En caso de ...

    • Crear y personalizar roles en el inbox de Escala

      Usuarios autorizados: Administradores. La misión: Crea roles y personaliza permisos para usar el Inbox Escala. En Escala puedes crear roles personalizados para el uso del Inbox y establecer el nivel de acceso a tu equipo de trabajo. Configura quién ...

    • Gestionar las notificaciones de tu cuenta en Escala

      Usuarios autorizados: Administradores, vendedores y editores. La misión: Lee las notificaciones de eventos prioritarios y recíbelas en tu email siguiendo estas 2 acciones. 1. Lee tus notificaciones pendientes 1.1 Para ver todas las notificaciones de ...

    • Activar y recibir notificaciones de WhatsApp vía email

      Usuarios autorizados: Administradores y vendedores. La misión: Activa y recibe notificaciones de WhatsApp vía email en 2 acciones. Ahora en Escala, podrás mantenerte informado de las conversaciones y respuestas de clientes o leads de tu Inbox Escala ...