Trabajar con webhooks desde bots

Al crear o editar un bot, puedes agregar un webhook haciendo clic en «+» para agregar una acción como normalmente lo harías. En el panel de selección de acción, haz clic en «Activar un webhook»trigger-a-webhook

A continuación, asígnale un apodo a tu acción e introduce la URL del punto final para el webhook. Si tu webhook enviará datos HubSpot en respuesta a la solicitud, revisa la casilla «Esperar los comentarios del webhook». (Lee más sobre esto a continuación) Guarda tu acción. trigger-a-webhook-editorCuando se alcanzó esta acción en una conversación, HubSpot enviará una carga JSON a la URL de webhook que hayas definido. La carga contendrá información relevante para la sesión de chat, incluidas las respuestas de los visitantes a cualquier pregunta, su ID de contacto e información sobre el bot.

Ejemplo de carga de solicitud:
//sample payload { "userMessage": { // Details for the last message sent to your bot "message": "100-500", // The last message received by your bot, sent by the visitor "quickReply": { // If the visitor selected any quick reply options, this will be a list of the selected options. // Will be 'null' if no options were selected. "quickReplies":[ // A list of quick reply options selected by the visitor { "value":"100-500", "label":"100-500" } ], }, "session": { "vid": 12345, // The contact VID of the visitor, if known. "properties": { // A list of properties collected by the bot in the current session. "CONTACT": { "firstname": { "value": "John", "syncedAt": 1534362540592 }, "email": { "value": "testing@domain.com", "syncedAt": 1534362541764 }, "lastname": { "value": "Smith", "syncedAt": 1534362540592 } } } } }

Los usuarios avanzados también tienen la opción de incluir JSON en la respuesta de tu webhook. Al hacerlo, puedes afectar el flujo de conversación o enviar un mensaje personalizado.

Ejemplo de carga de respuesta
//sample payload { "botMessage": null, // This is the message your bot will display to the visitor. "nextModuleNickname": "PromptForCollectUserInput", // If defined, this will be the next module your bot will go to. If undefined, the default configured behavior will be observed. "responseExpected": false // If true, the webhook will be triggered again with the visitor's next reply. If false, the default configured behavior will be observed. }

¿Te resultó útil este artículo?
Con este formulario puedes enviar tu opinión sobre nuestros documentos para desarrolladores. Si tienes comentarios sobre el producto de HubSpot, puedes enviarlos al Foro de ideas.