Skip to main content
Os webhooks avisam os seus sistemas sempre que ocorre um evento de chamada. A Jelou envia uma requisição POST para a URL que você registrar, o que permite levar o resultado de cada chamada ao seu CRM, ao seu data warehouse ou a qualquer fluxo interno sem precisar consultar o registro manualmente. Ficam na aba Webhooks do Voice.
Seção Registrar um webhook com o campo de URL e o botão Registrar, e abaixo a tabela de webhooks com URL, tipo e data de criação

Aba Webhooks com uma URL registrada

​
Registrar um webhook

Você cola a URL do seu endpoint no campo e confirma com Registrar. A Jelou enviará uma requisição POST para essa URL a cada evento de chamada da sua organização. A tabela abaixo lista os webhooks já registrados com três dados:
O alcance é toda a organização, não um agente ou um número específico. Um webhook registrado aqui recebe os eventos de chamada de todos os seus agentes.

​
Preparar o seu endpoint

O seu endpoint deve aceitar requisições POST com corpo JSON e responder rápido. Algumas considerações que valem para qualquer receptor de webhooks: Responda antes de processar. Devolva uma resposta de sucesso assim que receber o evento e faça o trabalho pesado de forma assíncrona. Se o seu endpoint demorar, você arrisca novas tentativas e duplicatas. Projete para a idempotência. Um mesmo evento pode chegar mais de uma vez diante de uma falha temporária. Use o identificador da chamada ou da conversa para reconhecer o que já processou. Use HTTPS e não confie apenas no segredo da URL. O painel não expõe um segredo de assinatura nem documenta um cabeçalho de verificação, portanto a URL é a única coisa que separa o seu endpoint do exterior. Proteja-o por conta própria: use um caminho difícil de adivinhar, restrinja o acesso por IP se a sua arquitetura permitir e trate tudo o que receber como não confiável até validar contra os seus próprios dados.
Se você precisa de verificação criptográfica da origem, confirme com a equipe da Jelou antes de construir sobre este webhook: não há um mecanismo de assinatura documentado nesta tela.
Registre o que recebe. Guardar o evento cru junto com a resposta que você deu economiza muito tempo quando algo não fecha.
Os eventos de chamada podem incluir dados da conversa e do interlocutor. Trate o endpoint e o que você armazenar com o mesmo cuidado que qualquer outro dado pessoal dos seus clientes.

​
O que fazer com os eventos

O evento de fim de chamada é o ponto natural para fechar o ciclo com os seus sistemas: registrar o resultado do contato, atualizar o estado de um caso ou disparar o próximo passo de um processo. Se você definiu critérios de avaliação e coleta de dados no agente, essa análise é o que transforma uma chamada em um registro utilizável: o motivo do contato, a classificação do resultado, se houve transferência.
Antes de construir a integração completa, registre um endpoint que apenas guarde o corpo da requisição e faça uma chamada de teste. Ver um evento real é mais rápido que deduzir a forma dele.

​
Pelo CLI

jelou voice webhooks

Liste, consulte, crie e exclua webhooks pelo terminal, indicando o tipo de evento.