Webhooks

Exemplos de webhooks

Com um webhook, a Voys envia um pedido HTTP para um URL fornecido assim que alguém liga. O que acontece a seguir depende de si: o servidor processa o pedido e envia algo de volta, e a chamada continua com base nisso. Por exemplo: encaminhar chamadas automaticamente com base nos seus próprios dados, procurar o nome de quem liga e mostrá-lo no telefone, ou simplesmente acionar o Zapier.

Não deixe de consultar

Notificações de chamada para maximizar as capacidades do seu serviço telefónico.

Resumindo: alguém liga → a Voys envia um pedido para o seu URL → o servidor responde com um estado (e opcionalmente alguns dados extra) → a Voys continua a chamada com base nisso.

Campos no formulário

Nome — como irá encontrar isto no plano de marcação
Descrição — apenas para si, não afeta nada
Transferência do identificador de chamadas — que número o destinatário vê: número de quem liga, número marcado ou suprimido
Modelo de URL — o URL que é chamado, veja abaixo as variáveis
Usar menu — ative se quem liga precisar de introduzir um código primeiro (estilo IVR). Adiciona 5 campos extra: tempo limite, número de tentativas, mensagem inicial, mensagem de erro, mensagem de tempo esgotado

Variáveis para o modelo de URL

{code}        the entered code (only relevant if the menu is on)
{did}         the number that was dialed
{callerid}    the caller's number
{callername}  caller's name, if known

Exemplo:

http://webrouting.voys.nl/test.py?code={code}&callerid={callerid}

A Voys preenche estas quatro variáveis automaticamente antes de fazer o pedido.

Configurar no plano de marcação

Aceda a Plano de marcação, escolha o número
Clique no mais, adicione um passo
Escolha Webhook como tipo, selecione o seu webhook
Obtém automaticamente dois caminhos: HTTP e menu bem-sucedidos e HTTP ou menu falharam

Em ambos os caminhos pode usar os passos normais do plano de marcação, mais duas opções extra: nome de quem liga variável e destino variável (veja abaixo).

O que enviar de volta

O servidor responde no formato application/x-www-form-urlencoded. Obrigatório: status. Opcional: destination e callername.

Estado:

ACK   input/request is valid
NAK   input is invalid
ERR   something went wrong

Apenas confirmar:

status=ACK

Encaminhar para um número diferente:

status=ACK&destination=%2B31502102544
status=ACK&destination=215

(destination pode ser um número externo ou uma extensão interna)

Alterar o nome de quem liga:

status=ACK&callername=VoysPartners

Nome de quem liga variável, três opções

Webhook — obtém o nome da resposta do servidor
Adicionar antes — adiciona o texto antes do nome existente
Substituir — substitui completamente o nome pelo texto

(Adicionar antes / Substituir também funcionam sem webhook, já agora.)

Destino variável

O servidor devolve um destination? Selecione "Destino variável" no passo de encaminhamento e a chamada segue automaticamente para lá.

Exemplos por caso de uso

1. Integração CRM

Numa chamada recebida, a Voys envia callerid e did para o CRM. Procura o cliente e devolve o nome que deve aparecer no telefone.

URL template:
https://crm.yourcompany.com/webhook?callerid={callerid}&did={did}

Response from your server:
status=ACK&callername=Marieke%20de%20Boer

2. Encaminhamento com base numa base de dados externa

Decida onde uma chamada deve ir, com base em quem liga, no número marcado ou num código pin.

URL template:
https://routing.yourcompany.com/lookup?callerid={callerid}&did={did}

Response from your server:
status=ACK&destination=%2B31502102544

3. Rastreamento de chamadas no Google Analytics

Cada campanha recebe o seu próprio número de um bloco. A Voys chama o URL com a campanha (did) e quem liga (callerid); regista a conversão e depois a Voys encaminha a chamada para o número real da empresa. Nota: a chamada em si não executa JS, por isso o rastreamento tem de acontecer do lado do servidor.

URL template:
https://analytics.yourcompany.com/call-tracking?campaign={did}&callerid={callerid}

Response from your server:
status=ACK&destination=020123456

4. Email / Slack numa chamada perdida

Normalmente via Zapier: o webhook publica num catch hook do Zapier, que o reencaminha para email, SMS ou Slack.

URL template (Zapier catch hook):
https://hooks.zapier.com/hooks/catch/123456/abcdef?callerid={callerid}&did={did}

What Zapier receives:
{
  "callerid": "+31612345678",
  "did": "0502102544",
  "timestamp": "2026-08-18T09:41:02+02:00"
}

5. Código pin VIP

Menu ativado, quem liga introduz um código, verifica se é válido.

URL template:
https://vip.yourcompany.com/check?code={code}&callerid={callerid}

Valid code:
status=ACK&destination=210

Invalid code:
status=NAK

6. Via Zapier para mais de 300 aplicações

Mesma ideia que acima, mas como um acionador genérico. Pode passar as quatro variáveis e deixar o Zapier decidir o que fazer com elas, para Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox, etc.

URL template:
https://hooks.zapier.com/hooks/catch/123456/xyz789?callerid={callerid}&did={did}&callername={callername}

What Zapier receives:
{
  "callerid": "+31612345678",
  "did": "0502102544",
  "callername": "Voys Partners"
}