Webhook de BotHelp

Un webhook es un mecanismo para notificar eventos al sistema. Cuando ocurre un evento, el servidor envía una solicitud de publicación a la dirección especificada en la URL del webhook.
En la plataforma BotHelp, puede configurar integraciones con otras plataformas mediante webhooks.

 

Formato de webhook

Cada webhook es una solicitud HTTP POST a la URL que especifique. El cuerpo de la solicitud contiene datos en formato JSON.
encabezado HTTP Content-Type: application/ json , así que asegúrese de que su servicio pueda gestionar dichas solicitudes.

 

Tipos de eventos

Eventos en bots

En un bot multipaso, un evento ocurre cuando un suscriptor llega al paso donde se escribe el webhook. En un bot lineal, esto ocurre cuando el suscriptor completa el bot.

 

Para obtener más información sobre qué datos se transmiten desde el bot, lea el artículo: Envío de un webhook .

 

Eventos en los chats

Hay dos tipos de eventos para los chats: ConversationClosed y UserProfileViewed. Estos eventos no están relacionados con los embudos automáticos, sino que se producen en la sección "Diálogos".
Para más información sobre los datos de estos eventos, consulte el artículo: Referencia de webhooks de chat .

 

Puedes configurar el webhook tú mismo o usar plataformas de integración especiales. Nuestra base de conocimientos contiene varias instrucciones sobre cómo usar estas plataformas. Búscalas en la sección correspondiente: Integraciones .

 

Pregunta: ¿Puede BotHelp aceptar datos de otras plataformas?
Respuesta: Sí, utilice la API abierta de BotHelp para ello. Encontrará instrucciones detalladas en nuestro artículo: API de BotHelp .

Envío de un webhook

Puedes conectar BotHelp con cualquier plataforma mediante la transferencia de datos de webhooks. Para ello, pega la URL del webhook en el campo correspondiente del bot.

¿Cómo agregar el envío de webhook?

Bot de varios pasos

  1. Crear una nueva acción.
  2. Agregue la acción "Enviar datos del suscriptor mediante webhook".
  3. Pegue el enlace del webhook en el campo.
  4. Guardar la acción.

El webhook transmitirá los datos que el usuario tenía en su perfil en el momento en que pasó por este bot.

 

¿Qué datos se transfieren?

  • La fecha en que se creó el perfil del suscriptor.
  • Nombre (completo, sólo nombre, sólo apellido).
  • Enlace al perfil.
  • Fecha del primer y último diálogo.
  • ID de suscriptor en el mensajero (incluido el nombre de usuario de Telegram).
  • ID de suscriptor en la cuenta de BotHelp.
  • CUID es un ID único para integraciones con GetCourse/Bizon365.
  • Etiquetas UTM.
  • Todos los campos y sus valores.

{
//Campos estándar
"created_at": 1499947711, //marca de tiempo
"name": "John Wick",
"first_name": "John",
"last_name": "Wick",
"profile_link": "https:\/\/fb.com\/1941325716136721",
"email": "john@gmail.com",
"phone": "+14123456789",
"conversations_count": 10,
"first_contact_at": 1499944111,
"last_contact_at": 1499944111,
"user_id": "1234567890",
"bothelp_user_id": "47659",
"created_at_show": "14/07/2017 07:56:32 UTC" //hora y fecha de creación de un cliente potencial para humanos ,

"cuid": "1et0.301" //Campos personalizados
"utm_source": "VK",
"utm_campaign": "messenger",
"utm_medium": "social_cpc",
"utm_content": "123"
"age": "21",
"position": "CEO en Pinapple",
}

 

¿Dónde puedo obtener una URL de webhook?

Si su programador configura la recepción de webhooks, le indicará la dirección a la que debe enviarse. Si utiliza servicios de integración especiales, le proporcionarán la URL en una de las etapas de configuración.

Tenemos instrucciones sobre cómo configurar la integración a través de servicios:

Úsalos para integrarlos con la plataforma que necesitas. Consulta la lista de plataformas disponibles para la integración en los sitios web de los integradores.


Si no has encontrado la respuesta a tu pregunta, pregúntanos en el chat dentro de tu cuenta o escríbenos a BotHelpSupportBot o a hello@bothelp.io

Obtenga 14 días de funcionalidad completa de la plataforma para crear mailings, autofunnels y chatbots BotHelp.

Obtenga 14 días gratis

¿Fue útil este artículo?

¡Gracias por tus comentarios!