Integração com Vapi AI

Vapi AI é um serviço para criação de assistentes de voz com recurso a inteligência artificial. Os assistentes de voz podem atender e efectuar chamadas de forma autónoma ou fazer parte de uma equipa de operadores. Existe uma vasta seleção de vozes para síntese de fala e opções avançadas de personalização da voz, como escolha da velocidade da fala, sons de fundo, utilização de pré-discagem e muito mais.

• Assistente de voz com IA como um dos operadores da central telefónica virtual.
• Adicione o assistente de IA à fila de chamadas como último elemento e ele atenderá a chamada se os outros membros da equipa (humanos) estiverem ocupados.
• Fora do horário de trabalho ou em feriados, o assistente de IA pode atender chamadas em vez do atendedor automático.
• Pode transferir a chamada para o número interno do assistente de IA, tal como faria para o número interno de um colega.

1) Na área pessoal do Vapi AI, aceda às definições da sua organização e, na secção API keys, copie a sua Private Key

Adição do login SIP, palavra-passe e endereço do servidor no Vapi AI

É necessário compor e enviar um pedido curl com os seguintes dados:

• badcf222-9542-4d39-a834-fef874b7aec1 – A sua Private Key da área pessoal do Vapi AI.
• Zadarma Trunk - Nome do trunk.
• sip.zadarma.com - Endereço do servidor para ligação e envio de chamadas para o exterior.
• 111111 - O seu número SIP disponível na área pessoal.
• SipPassword - A sua palavra-passe do número SIP, que pode ser gerada aqui.

• badcf222-9542-4d39-a834-fef874b7aec1 – A sua Private Key da área pessoal do Vapi AI.
• Zadarma Trunk - Nome do trunk.
• pbx.zadarma.com - Endereço do servidor para ligação e envio de chamadas para o exterior.
• 1234-100 - O seu número interno da central telefónica, disponível na área pessoal.
• PbxPassword - A sua palavra-passe do número interno da central telefónica, que pode ser gerada aqui.

curl -L 'https://api.vapi.ai/credential' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer badcf222-9542-4d39-a834-fef874b7aec1' \
-d '{
"provider": "byo-sip-trunk",
"name": "Zadarma Trunk",
"gateways": [
{ "ip": "sip.zadarma.com" }
],
"outboundLeadingPlusEnabled": true,
"outboundAuthenticationPlan": {
"authUsername": "111111",
"authPassword": "SipPassword"
}
}'

curl -L 'https://api.vapi.ai/credential' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer badcf222-9542-4d39-a834-fef874b7aec1' \
-d '{
"provider": "byo-sip-trunk",
"name": "Zadarma Trunk",
"gateways": [
{ "ip": "pbx.zadarma.com" }
],
"outboundLeadingPlusEnabled": true,
"outboundAuthenticationPlan": {
"authUsername": "1234-100",
"authPassword": "PbxPassword"
}
}'

Se o pedido for composto corretamente, a resposta incluirá os seguintes dados:

{"id":"7c97ecbe-7e1d-4fa1-8259-8ed32f8a9edd","orgId":"487ba655-4fb2-4a55-abfe-ddded2442631","provider":"byo-sip-trunk","createdAt":"2025-02-25T11:24:02.450Z","updatedAt":"2025-02-25T11:24:02.450Z","gateways":[{"ip":"sip.zadarma.com"}],"name":"Zadarma Trunk","outboundAuthenticationPlan":{"authUsername":"111111"},"outboundLeadingPlusEnabled":true}

{"id":"7c97ecbe-7e1d-4fa1-8259-8ed32f8a9edd","orgId":"487ba655-4fb2-4a55-abfe-ddded2442631","provider":"byo-sip-trunk","createdAt":"2025-02-25T11:24:02.450Z","updatedAt":"2025-02-25T11:24:02.450Z","gateways":[{"ip":"pbx.zadarma.com"}],"name":"Zadarma Trunk","outboundAuthenticationPlan":{"authUsername":"1234-100"},"outboundLeadingPlusEnabled":true}

2) Adição de número virtual no Vapi AI

Para isso, é necessário compor e enviar um segundo pedido curl com os seguintes dados:

• badcf222-9542-4d39-a834-fef874b7aec1 – A sua Private Key da área pessoal do Vapi AI.
• Zadarma Number - Nome do número.
• 15551111111 - O seu número virtual disponível na área pessoal.
• Zadarma Trunk – Nome do trunk.
• 7c97ecbe-7e1d-4fa1-8259-8ed32f8a9edd – ID da resposta ao primeiro pedido.

curl -L 'https://api.vapi.ai/phone-number' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer badcf222-9542-4d39-a834-fef874b7aec1' \
-d '{
"provider": "byo-phone-number",
"name": "Zadarma Number",
"number": "15551111111",
"numberE164CheckEnabled": false,
"credentialId": "7c97ecbe-7e1d-4fa1-8259-8ed32f8a9edd"
}'

3) Na área pessoal do Vapi AI, abra a secção Build - Phone numbers, aceda ao seu Zadarma Number e, na secção Inbound Settings, no parâmetro Assistant, seleccione o seu assistente de voz que irá receber as chamadas recebidas. Mais abaixo na página, na secção Outbound Form, no parâmetro Assistant, seleccione o seu assistente de voz que irá efectuar as chamadas para o exterior.

4. Configuração da recepção de chamadas na Zadarma

Para receber chamadas, configure o reencaminhamento de chamadas da Zadarma para o Vapi AI:

1. Aceda à Zadarma na secção Definições → Números virtuais.
2. Ao lado do seu número, clique no ícone ⚙ (roda dentada).
3. Abra o separador "Servidor externo".
4. Ative a opção "Servidor externo (SIP URI)".
5. No campo que aparecer, introduza o seguinte endereço: 15551111111@sip.vapi.ai, onde 15551111111 é o seu número virtual no formato internacional.
6. Clique em "Guardar".

1. Aceda à Zadarma na secção A Minha Central Telefónica → Números Internos.
2. Nas definições do número interno, ao lado do parâmetro "Reencaminhamento e voicemail", clique em "Ativar".
3. Seleccione a condição de reencaminhamento, por exemplo "Sempre".
4. No parâmetro "Reencaminhar para", seleccione "Servidor externo (SIP URI)".
5. No campo que aparecer, introduza o seguinte endereço: 15551111111@sip.vapi.ai, onde 15551111111 é o seu número virtual no formato internacional.
6. Clique em "Guardar".