O que é um Webhook?
O módulo Webhooks permite uma personalização alargada 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 de telefonia.
Como criar um Webhook?
- Aceda a Webhooks.
- Clique em Adicionar.
- Atribua um nome ao seu Webhook.
- Opcionalmente, forneça informações adicionais no campo descrição. Isto não é necessário para o webhook funcionar.
- Em Transmissão de Identificador de Chamadas, escolha qual o número que o destinatário da chamada verá como identificador de chamadas:
- Número do chamador.
- Número chamado.
- Suprimido (anónimo).
- No campo Modelo de URL, insira o URL que deve ser acionado aquando de uma chamada recebida. 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 utilizadas quatro variáveis no modelo de URL:
- {code}: O código de dígitos inserido pelo chamador (consulte "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)
Assinale esta opção se pretender que o chamador insira um código de dígitos para prosseguir. Após selecionar esta opção, surgirão cinco campos adicionais:
- Tempo limite: Insira o número de segundos que o chamador tem para introduzir o seu código de dígitos.
- Número de tentativas: Insira o número de vezes que o chamador pode tentar inserir 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 inserir um código de dígitos incorreto.
- Mensagem de tempo limite: Selecione o Som a ser reproduzido se o período de tempo limite 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 utilizar o webhook.
- Clique em Editar Plano de Marcação.
- Clique em Adicionar Passo no local onde pretende inserir o webhook.
- Verá dois subpassos:
- Sucesso de HTTP e IVR: Estes subpassos são executados se o webhook devolver os valores corretos (o URL está ligado) e o chamador tiver potencialmente inserido uma opção IVR válida.
- Falha de HTTP ou IVR: Estes subpassos são executados se houver algum problema, como o chamador fazer uma escolha inválida ou se o URL não estiver a funcionar, possivelmente devido a um problema no 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 as suas utilizações:
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: Set the caller name to the value returned by the webhook.
- Prefix: Enter text in the routing step that will be prefixed to the caller's name.
- Replace: Enter text in the routing step that will replace the caller's name entirely.
Nota: Nome de chamador variável também pode ser usado fora do webhook. Nesse caso, apenas as opções Adicionar Prefixo e Substituir podem ser utilizadas.
Destino variável
Se o webhook fornecer um destino, pode reencaminhar a chamada para esse 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: A entrada está correta.
- NAK: A entrada não é válida.
- ERR: Ocorreu um erro.
Destino
Utilizado para desviar para outro destino.
Nome do Contacto
Utilize isto se pretender mostrar o nome do contacto ou o estado da chamada (como escolha de 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=%2B31502102544
O pedido foi processado com sucesso e a chamada deve ser desviada para o número +31 50 210 2544.
status=ACK&destination=215
O pedido foi processado com sucesso e a chamada deve ser desviada para o número 215.
status=ACK&callername=VoIPGRID
O pedido foi processado com sucesso e o nome do contacto deve ser definido como "VoIPGRID".
Explorar utilizações alternativas para o Webhook
Integração com CRM
Quando uma chamada é recebida, enviamos um impulso para o sistema CRM. Este impulso inclui o número do contacto (se conhecido) e o número que foi 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 tem de ser tratada no próprio CRM.
Comutação com base numa base de dados externa
Podemos desviar chamadas recebidas para um número de telefone devolvido por um sistema externo. Isto pode ser baseado em:
- O número do contacto
- O número chamado
- Um código PIN introduzido
Rastreio de chamadas telefónicas no Google Analytics
Para rastrear 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 rastrear até 10 campanhas simultaneamente.
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 contacto (se disponível). Tenha em atenção que o nosso sistema não processa JavaScript ou scripts semelhantes, por isso é necessário executar um código após o URL ser chamado para medir corretamente a conversão.
Depois do URL ser chamado, desviamos a chamada para o número principal da empresa e a campanha fica rastreada.
Receber email para chamadas não atendidas
Quando uma chamada não é atendida, pode ser útil receber o número de telefone do contacto por email, mensagem SMS ou via Slack, por exemplo, que inclua data, hora e número chamado. Consulte os exemplos de Webhooks para um exemplo detalhado através de uma ligação Zapier com webhooks.
Código PIN VIP
Pode utilizar um webhook para atribuir um código PIN VIP específico a clientes, como para uma linha de suporte dedicada. Para mais detalhes sobre como configurar isto, visite a página Código PIN VIP.
Ligação a mais de 300 aplicações web através do Zapier
Pode ligar facilmente o seu webhook ao Zapier, de forma 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.
FAQ
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 utilizado um URL diferente para cada webhook configurado. Um webhook é chamado num único momento no tempo.
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, utilize um pedido GET.
- Para notificações de chamada, utilize um pedido POST.