API
Webhook
6min
una excelente manera de incorporar las conversaciones dentro de tu propio sistema es a través de la implementación de un webhook hacia tu servicio web este proceso te permitirá establecer una conexión bidireccional entre tu sistema y el chat, lo cual resultará en una integración mucho más fluida y eficiente es importante destacar que la url que ingreses en el webhook se ejecutará cuando se archive la conversación esto significa que la url recibirá un json con toda la información de la conversación en formato json una vez que la conversación haya sido archivada puede ser que el bot archive la conversación automáticamente o que un agente lo haga manualmente para llevar a cabo la configuración del webhook, deberás dirigirte a la sección de configuración de la plataforma y acceder a la pestaña de webhooks una vez allí, serás capaz de ingresar la url correspondiente a tu sistema, la cual servirá como punto de enlace para el intercambio de información asegúrate de ingresar la dirección web de tu sistema de manera precisa y verídica, ya que esto será crucial para garantizar una correcta comunicación una vez establecido el webhook, podrás comenzar a recibir y procesar los datos provenientes de las conversaciones archivadas, permitiéndote así personalizar y adaptar la experiencia del usuario de acuerdo a tus propias necesidades y requerimientos en resumen, la implementación de un webhook hacia tu servicio web es un enfoque altamente recomendado para integrar conversaciones en tu sistema te brinda mayor control y flexibilidad, además de proporcionarte toda la información de la conversación en un formato json una vez que la conversación haya sido archivada aprovecha esta funcionalidad para automatizar procesos y mejorar la interacción con los usuarios de manera eficiente ejemplo de json enviado { "event type" "ticket closed", "ticket id" "#1fy", "timestamp" 1586229907754, "channel" "web", "source" "chat", "source id" null, "status" "closed", "subject" "i'm interested in the new red shoes", "department" { "id" 93, "name" "customer support" }, "bot" { "id" 25478, "name" "agustin", "transferred to agent" true }, "agent" { "id" 569884, "name" "agustin", "email" "agustin\@fabrics l com" }, "customer" { "fingerprint" "k811xkn31fhzcss0dia8bbd3sr56l20lpx6gx76y", "name" "john", "email" "john\@gmail com", "phone" "", "facebook id" "", "sentiment" "", "ip" "95 256 142 145", "browser os" "chrome on windows 10 64 bit", "country code" "us", "country name" "united states" }, "event" { "calendar id" "1", "base36 id" "hx34s", "customer locale" "es", "customer timezone" " 3", "event status" "active", "event url" "", "friendly" "chrome on windows 10 64 bit", "location" "av libertador 2632, olivos" }, "messages" \[ { "action" "out", "timestamp" 1586229888461, "name" "bruno", "message" "hi john! i'm bruno, a virtual assistant how can i help you?" }, { "action" "in", "timestamp" 1586229891562, "name" "john", "message" "i'm interested in the new red shoes" }, ] } headers el encabezado siempre tendrá el valor asisteclick access token con el access token de la cuenta este token es esencial para autenticar y autorizar el acceso a la cuenta del cliente en el servicio web el access token de la cuenta lo obtiene cualquier usuario con nivel de administrador por otro lado, en caso de que el servicio web del cliente requiera de valores de encabezado adicionales, estos se agregarán en la misma url con un formato especial este formato asegura que los valores de encabezado se transmitan correctamente al servidor y se utilicen de acuerdo a las necesidades del cliente https //www tuempresa com/tuservicio origen\ bot para agregar headers al final de la url, se debe escribir " " para separar la url del header adicional a continuación, se debe especificar el nombre del header seguido de " " y el valor correspondiente en el ejemplo mencionado anteriormente, el nombre del header es "origen" y el valor es "bot" en caso de necesitar varios headers, se separan por ";" por ejemplo https //www tuempresa com/tuservicio origen\ bot;servicio\ web en este último ejemplo, el webhook será enviado a la url https //www tuempresa com/tuservicio agregando en el header los valores origen=bot y servicio=web tipos de eventos (event type) la plataforma realiza el callback a la url cuando se ocurren los siguientes eventos conversación archivada por un chatbot event type = ticket handoff conversación archivada por un usuario event type = ticket closed creación de un evento de agenda event type = event created actualización de un evento de agenda event type = event updated cancelación de un evento de agenda event type = event canceled