Enviando dados para análise através de Webhooks 16 de janeiro de 2025 11:53 Atualizado Índice: Pré-requisitos Testando Cadastrando um Webhook Tipos de envio OAuth 2.0 Cabeçalhos customizados Caso você deseje acessar os dados gerados pelo seu bot em outras ferramentas de análise, é possível configurar Webhooks para disponibilizar 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: Caso seja detectado um grande volume de falhas consecutivas no envio do mesmo tipo de dado (contatos, eventos, mensagens ou tickets), a integração será bloqueada por 4 horas. Mais detalhes aqui. Pré-requisitos Para usar essa integração, você precisa ter um serviço com URL pública, configurado para receber requisições HTTPS do método POST com objetos do tipo JSON no corpo da requisição. Recomendamos responder aos envios com um código HTTP 200 OK. Em muitos casos de uso é comum que seja necessário desenvolver uma API simples que capture esses envios e os redirecione para o destino final (banco de dados, data lake ou outros sistemas). Veja aqui mais detalhes sobre o formato dos envios. Testando Se você ainda não possui uma API implementada para receber os envios do Blip, pode utilizar ferramentas de terceiros disponíveis online para testar o recebimento e analisar o formato dos dados. Alguns exemplos: https://webhook.site/ https://webhook.cool/ https://webhook-test.com/ Observação.: Essas ferramentas não servem como solução final, e a Blip não tem nenhuma relação com elas. Cadastrando um Webhook Acesse o portal do Blip, selecione o seu bot e vá até o módulo Integrações. Escolha a opção Webhook. Em Configurações, adicione pelo menos uma URL para receber as informações enviadas pelo Blip. Certifique-se de ativar a chave no canto superior direito. O webhook utiliza um sistema de fila, onde os dados são enfileirados para envio imediatamente após sua geração. Durante períodos de alto tráfego, o processamento dos envios pode demorar mais, chegando até cerca de 2 horas. Configurações Avançadas Opcionalmente, é possível configurar opções avançadas para cada URL cadastrada, permitindo personalizar o envio de acordo com suas necessidades: Tipos de envio OAuth 2.0 Cabeçalhos customizados Observação: Mudanças nessas configurações podem levar alguns minutos para entrar em vigor devido ao cache. Tipos de envio Você não precisa receber todos os tipos de informações que o Blip gere em uma mesma URL, caso não deseje. É possível selecionar se deseja receber apenas Contatos, Eventos, Mensagens ou Tickets (em breve). Esse recurso também permite separar uma URL específica para cada tipo de item, facilitando o tratamento e a organização dos dados. OAuth 2.0 O OAuth 2.0 é um padrão de autorização que permite proteger a URL cadastrada sem expor credenciais sensíveis. Atualmente, suportamos o fluxo Client Credentials, utilizado para autenticação entre servidores. Cabeçalhos customizados As chaves e valores cadastrados aqui são adicionados como cabeçalhos (headers) na requisição HTTPS. Eles podem ser usados para enviar valores arbitrários úteis para sua API ou para implementar um sistema simples de autenticação, caso o OAuth 2.0 não seja a melhor opção. 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 Data Extractor (Acesso a Dados)