Realización de una llamada antes de procesar un mensaje

Un webhook pre-mensaje realiza una llamada a un servicio o aplicación externa cada vez que un cliente envía una entrada. El servicio externo puede procesar el mensaje antes de que lo haga su asistente.

Añade un webhook pre-mensaje a tu asistente si quieres que el webhook se active antes de que cada mensaje entrante sea procesado por tu asistente.

Si utilizas un canal personalizado, el webhook pre-mensaje sólo funciona con la versión 2 de la API /message, stateless y stateful. Para obtener más información, consulte la Referencia de API. Todas las integraciones de canal incorporadas utilizan esta API.

Puede utilizar webhooks pre-mensaje para los siguientes casos de uso:

  • Traduzca las entradas del cliente al idioma que utiliza su asistente.

  • Buscar y eliminar la información de identificación personal, como una dirección de correo electrónico o un número de la seguridad social enviados por un cliente.

Puede utilizar este webhook en coordinación con el webhook post-mensaje. Por ejemplo, el webhook posterior al mensaje puede hacer cosas como traducir la respuesta al idioma del cliente o volver a añadir información que se eliminó por motivos de privacidad. Para obtener más información, consulte Realización de una llamada después de procesar un mensaje.

En entornos en los que se utilizan puntos finales privados, recuerde que el webhook envía tráfico a través de Internet.

Utiliza un webhook de diálogo si necesitas realizar una acción puntual cuando sea necesario durante una conversación. Por ejemplo, las condiciones se cumplen cuando el asistente recopila todos los datos necesarios, como el número de cuenta, el ID de usuario y el secreto de cuenta. Para obtener más información, consulte Realizar una llamada mediante programa desde el diálogo.

Definición del webhook

Puede definir un URL de webhook para utilizarlo en el preprocesamiento de cada mensaje entrante.

Antes de empezar

La llamada programática al servicio externo debe cumplir los siguientes requisitos:

  • No configure ni pruebe el webhook en un entorno de producción en el que el asistente se haya desplegado y esté interactuando con los clientes.
  • La llamada debe ser una solicitud POST HTTP.
  • El cuerpo de la solicitud debe ser un objeto JSON (Content-Type: application/json).
  • La llamada debe responder en 30 segundos o menos.

Si su servicio externo sólo admite solicitudes GET, o si necesita especificar parámetros URL dinámicamente en tiempo de ejecución, considere la posibilidad de crear un servicio intermedio que acepte una solicitud POST con una carga útil JSON que contenga cualquier valor en tiempo de ejecución. A continuación, el servicio intermedio puede efectuar una solicitud al servicio de destino, en la que pasará estos valores como parámetros de URL, y, a continuación, devolver la respuesta al diálogo.

Elección del método de implantación

Selecciona el método de despliegue que utilizas para ver los pasos correctos para configurar un webhook pre-mensaje.

Para identificar qué tipo de despliegue está utilizando, haga clic en el menú Gestionar. Si ves Cambiar a la experiencia clásica, estás utilizando la nueva experiencia. Si ves Cambiar a nueva experiencia, estás utilizando la experiencia clásica.

Utilice los siguientes enlaces para conocer los procedimientos en función de su tipo de implantación: