Enviando dados para análise através de Webhooks 24 de janeiro de 2024 00:28 Atualizado Caso você deseje acessar os dados gerados pelo seu bot em outras ferramentas de análise de dados, é possível configurar Webhooks para que você acesse essas informações fora do Blip. Ao configurar um Webhook, todas as informações de mensagens, eventos e contatos trafegadas na plataforma, serão enviadas para as URLs definidas para o seu bot. Atenção: se for detectado um grande volume de requisições que falharem consecutivamente para o mesmo tipo de dado (contato, eventos, mensagens), a integração será bloqueada por 4 horas. Adicionando um Webhook Acesse o portal do Blip, selecione seu bot e escolha o módulo Integrações. Escolha a opção Webhook e adicione pelo menos uma URL que receberá todas as informações enviadas pelo Blip. Caso sejam adicionadas mais de uma URL, todas receberão as mesmas informações. Importante: Caso sejam adicionadas mais de uma URL, todas receberão as mesmas informações. O webhook não funciona em tempo real, podendo levar até 2 horas para o evento ser enviado e as informações fiquem disponíveis. Exemplo: Imagine que a aplicação responsável por receber as informações enviadas pelo Blip está disponível na URL https://requestb.in/14rxsmm1 . Adicione a URL no portal do Blip, clique no botão Salvar e depois clique na chave Ativar conforme indicado na figura abaixo. Caso seja necessário adicionar uma nova URL, clique no botão Adicionar. Observação: Essa URL deve estar preparada para receber requisições HTTPS do método POST com objetos do tipo JSON no body da requisição. Os objetos recebidos pela aplicação definida no Webhook seguem as definições dos documentos Message e Events. Exemplo de requisição realizada pelo Blip (na aplicação configurada) quando o chatbot recebe uma mensagem de um usuário no canal Facebook. HTTP/1.1 200 OKContent-Type: application/json{"id": "65603604-fe19-479c-c885-3195b196fe8e","from": "182310923192@messenger.gw.msging.net","to": "mychatbot@msging.net","type": "text/plain","content": "Hello World!"} Quando um registro de evento (event-track) é gerado no fluxo: HTTP/1.1 200 OKContent-Type: application/json{ "ownerIdentity": "frostyrouter@msging.net", "identity": "182310923192@messenger.gw.msging.net", "contact": { "Identity": "182310923192@messenger.gw.msging.net" }, "messageId": "6999c28d-6c89-4017-ab7b-b88b34f045a7", "storageDate": "2021-07-16T16:53:11.961Z", "category": "flow", "action": "Boas Vindas", "extras": { "#stateName": "Boas vindas", "#stateId": "welcome", "#messageId": "6999c28d-6c89-4017-ab7b-b88b34f045a7", "#previousStateId": "onboarding", "#previousStateName": "Início" }} Quando um contato é editado no fluxo: HTTP/1.1 200 OKContent-Type: application/json{ "name": "joao", "lastMessageDate": "2021-07-15T14:30:06.610Z", "identity": "182310923192@messenger.gw.msging.net", "city": "sao luis, MA", "email": "email@gmail.com", "phoneNumber": "1312341", "extras": { "carteirinha": "4123123", "intenção": "sorvete" }, "source": "0mn.io", "taxDocument": "6303030303"} Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Regra de bloqueio de URLs inválidas no Webhook Envio de Mensagens Ativas do WhatsApp no Blip Desk Mensagens Ativas - Códigos de erro Dashboard - Análise de Dados Como enviar SMS via API