O que é um Webhook?
O módulo Webhooks permite uma personalização extensiva ao possibilitar pedidos HTTP para URLs externos, desencadeando várias ações com base nos dados devolvidos. Seja para abrir uma barreira para chamadas específicas, enviar e-mails para contactos de clientes ou integrar com sistemas CRM e campanhas de marketing, as possibilidades são vastas. Configure o URL e as opções para adaptar funcionalidades como desvio de chamadas ou consultas de base de dados de acordo com as suas necessidades.
Não deixe de consultar Notificações de chamada para maximizar as capacidades do seu serviço telefónico.
Como criar um Webhook?
- Aceda a Webhooks.
- Clique em Adicionar.
- Dê um nome ao seu Webhook.
- Opcionalmente, forneça informação adicional no campo descrição. Isto não é necessário para o webhook funcionar.
- Em Transmissão do Identificador de Chamadas, escolha qual o número que o destinatário da chamada verá como identificador:
- Número do chamador.
- Número chamado.
- Suprimido (anónimo).
- No campo Modelo de URL, introduza o URL que deve ser acionado quando recebe uma chamada. O texto de ajuda no formulário fornece mais detalhes. Este campo especifica como o URL a ser chamado pelo webhook deve ser formatado. Podem ser usadas quatro variáveis no modelo de URL:
- {code}: O código de dígitos introduzido pelo chamador (veja "Usar IVR" abaixo).
- {did}: O número chamado.
- {callerid}: O identificador de chamadas do chamador.
- {callername}: O nome do chamador, se disponível.
Um exemplo simples de um modelo de URL poderia ser:
http://webrouting.companyname.com/test.py?code={code}&callerid={callerid}
Usar IVR (Interactive Voice Response)
Selecione esta opção se pretende que o chamador introduza um código de dígitos para prosseguir. Após selecionar esta opção, aparecerão cinco campos adicionais:
- Timeout: Introduza o número de segundos que o chamador tem para inserir o código de dígitos.
- Número de tentativas: Introduza o número de vezes que o chamador pode tentar introduzir o código de dígitos corretamente.
- Mensagem inicial: Selecione o Som a ser reproduzido quando o chamador é direcionado para este webhook.
- Mensagem de erro: Selecione o Som a ser reproduzido se o chamador introduzir um código de dígitos incorreto.
- Mensagem de timeout: Selecione o Som a ser reproduzido se o período de timeout for excedido.
- Clique em Guardar.
Se tudo estiver configurado corretamente, será agora estabelecida uma ligação entre a sua plataforma de telefonia e o seu script, pacote CRM, Zapier ou outro programa. Só precisa de ativar este Webhook no seu plano de marcação.
Configurar Webhooks no plano de marcação
- Aceda a Planos de marcação.
- Clique no número de telefone onde pretende usar o webhook.
- Clique em Editar Plano de Marcação.
- Clique em Adicionar Passo no local onde pretende inserir o webhook.
- Verá dois sub-passos:
- Sucesso HTTP e IVR: Estes sub-passos são executados se o webhook devolver os valores corretos (o URL está ligado) e o chamador tiver potencialmente introduzido uma opção IVR válida.
- Falha HTTP ou IVR: Estes sub-passos são executados se houver um problema, como o chamador fazer uma escolha inválida ou se o URL não estiver a funcionar, possivelmente devido a um problema de servidor.
O que incluir no seu Webhook
Pode integrar vários elementos no seu webhook tal como faria no seu plano de marcação. Abaixo estão algumas opções e os seus usos:
Variável de Nome do Chamador
O nome do chamador—o nome que o destinatário vê no seu ecrã—pode ser ajustado de três formas:
- Webhook: Define o nome do chamador para o valor devolvido pelo webhook.
- Prefixo: Introduza texto no passo de encaminhamento que será adicionado como prefixo ao nome do chamador.
- Substituir: Introduza texto no passo de encaminhamento que substituirá completamente o nome do chamador.
Nota: Nome de chamador variável também pode ser usado fora do webhook. Nesse caso, apenas as opções Adicionar como Prefixo e Substituir podem ser usadas.
Destino variável
Se o webhook fornecer um destino, pode reencaminhar a chamada para este destino selecionando "Destino variável" no passo de encaminhamento (na secção do webhook).
Feedback que pode fornecer ao sistema
Forneça o seguinte feedback para indicar o estado da interação do webhook.
Estado
- ACK: Entrada correta.
- NAK: A entrada não é válida.
- ERR: Ocorreu um erro.
Destino
Utilizado para encaminhar para outro destino.
Nome do Chamador
Use isto se pretender apresentar o nome do chamador ou o estado da chamada (como uma escolha IVR) num dispositivo VoIP.
Interpretação do feedback
status=ACK
O pedido foi recebido e processado com sucesso com entrada válida.
status=ACK&destination=%2B351502102544
O pedido foi processado com sucesso e a chamada deve ser encaminhada para o número de destino +351 50 210 2544.
status=ACK&destination=215
O pedido foi processado com sucesso e a chamada deve ser encaminhada para o número de destino 215.
status=ACK&callername=VoIPGRID
O pedido foi processado com sucesso e o nome do chamador deve ser definido como "VoIPGRID."
Explorar utilizações alternativas para o Webhook
Integração com CRM
Quando uma chamada entra, enviamos um sinal para o sistema CRM. Este sinal inclui o número do chamador (se conhecido) e o número marcado. O CRM devolve então o nome que deve ser apresentado, e mostramos esse nome no ecrã do telefone VoIP.
Opcionalmente, o CRM também pode abrir um perfil de cliente com base na chamada recebida — mas essa lógica precisa de ser gerida dentro do próprio CRM.
Encaminhamento baseado numa base de dados externa
Podemos encaminhar chamadas recebidas para um número de telefone devolvido por um sistema externo. Isto pode basear-se em:
- O número do chamador
- O número chamado
- Um código PIN introduzido
Acompanhar chamadas telefónicas no Google Analytics
Para acompanhar chamadas telefónicas, é necessário um bloco de números. Atribua um número único a cada campanha. Com um bloco de 10 números, pode acompanhar até 10 campanhas em simultâneo.
Quando um cliente liga para um dos números do bloco, enviamos um URL contendo o número chamado (representando a campanha) e o número do chamador (se disponível). Tenha em atenção que o nosso sistema não processa JavaScript ou scripts semelhantes, pelo que deve ser executado um pedaço de código após a chamada do URL para medir adequadamente a conversão.
Após a chamada do URL, encaminhamos a chamada para o número principal da empresa e a campanha fica registada.
Receber e-mail para chamadas perdidas
Quando uma chamada é perdida, pode ser útil receber o número de telefone do chamador num e-mail, mensagem SMS ou via Slack, por exemplo, que inclua data, hora e número chamado. Consulte Exemplos de Webhooks para um exemplo detalhado através de uma ligação Zapier com webhooks.
Código PIN VIP
Pode usar um webhook para atribuir um código PIN VIP específico aos clientes, como para uma linha de suporte dedicada. Para detalhes sobre como configurar isto, visite a página Código PIN VIP.
Ligar a mais de 300 aplicações web através do Zapier
Pode ligar facilmente o seu webhook ao Zapier, semelhante ao IFTTT (If This Then That). O Zapier permite integrar vários sistemas, para que uma ação num serviço web possa desencadear ações noutros, criando uma reação em cadeia. O Zapier suporta integração com serviços como Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox e muitos outros.
Perguntas Frequentes
Os webhooks são acionados num ponto específico do plano de marcação e funcionam apenas para chamadas recebidas. Se necessário, pode ser usado um URL diferente para cada webhook configurado. Um webhook é chamado num único momento.
As notificações de chamada funcionam tanto para chamadas recebidas como efectuadas. Para mais detalhes, consulte:
Com as notificações de chamada, o URL pode ser chamado em cinco pontos diferentes do ciclo de vida da chamada.
- Para webhooks, use um pedido GET.
- Para notificações de chamada, use um pedido POST.