ZapCall - Manual de Configuracao

WhatsApp SIP Trunk para Asterisk

Versao 1.0 - Julho 2026

Importante: Este manual contem as instrucoes completas para configurar seu WhatsApp como tronco SIP no Asterisk. Siga cada passo cuidadosamente.

1. Pre-requisitos

Servidor Asterisk 1.8 ou superior (FreePBX, Issabel, Elastix, etc.)
ZapCall ativado com QR Code escaneado
Acesso SSH ao servidor Asterisk
Host do servidor ZapCall: sip.chatbots.net.br
Token de autenticacao (fornecido na ativacao)

2. Dados de Conexao

Parametro	Valor
Servidor ZapCall	sip.chatbots.net.br
Porta SIP	5060 (UDP)
Username	Seu numero WhatsApp (ex: 5511999999999)
Secret/Password	Token fornecido na ativacao
Codec	alaw (G.711 A-law)

3. Configuracao sip.conf

Adicione as seguintes linhas ao final do arquivo /etc/asterisk/sip.conf:

register => NUMERO-WHATSAPP:secret@sip.chatbots.net.br/NUMERO-WHATSAPP

[NUMERO-WHATSAPP]
type=friend
port=5060
fromuser=NUMERO-WHATSAPP
defaultuser=NUMERO-WHATSAPP
host=sip.chatbots.net.br
fromdomain=sip.chatbots.net.br
qualify=yes
disallow=all
allow=alaw
dtmfmode=rfc2833
transport=udp
nat=force_rport,comedia
insecure=port,invite
context=rota_entrada_inicial
sendrpid=yes
trustrpid=yes

Troque NUMERO-WHATSAPP pelo seu numero completo (ex: 5511999999999) em todas as ocorrencias.
Troque secret pelo token recebido na ativacao.
Mantenha o host sip.chatbots.net.br e a porta 5060 (UDP).

4. Configuracao extensions.conf

Adicione ao final do arquivo /etc/asterisk/extensions.conf:

;LINHA DA ENTRADA DE LIGACAO
[rota_entrada_inicial]
exten => NUMERO-WHATSAPP,1,NoOp(WhatsApp entrante: NUMERO-WHATSAPP)
 same => n,Dial(SIP/6000,60,tT)
 same => n,Hangup()

;LINHA DO DIAL:
[teste-saida-whatsapp]
exten => _99X.,1,Dial(PJSIP/55${EXTEN:2}@NUMERO-WHATSAPP,60,T)
 same => n,Hangup()

5. Explicacao do Dialplan

rota_entrada_inicial: Contexto das chamadas recebidas do WhatsApp. A chamada e entregue no ramal 6000; ajuste para seu ramal, fila ou grupo.
teste-saida-whatsapp: Para ligar pelo WhatsApp, disque 99 + numero com DDD. O prefixo 99 e removido e o 55 e adicionado automaticamente.

6. Configuracao PJSIP (Alternativa)

Se seu Asterisk utiliza PJSIP, adicione ao /etc/asterisk/pjsip.conf:

[transporte-udp]
type=transport
protocol=udp
bind=0.0.0.0:5060
local_net=192.168.0.0/255.255.0.0
local_net=10.0.0.0/255.0.0.0
local_net=172.16.0.0/255.240.0.0
local_net=127.0.0.1/32
external_media_address=DNS-DO-PABX
external_signaling_address=DNS-DO-PABX
allow_reload=yes


[NUMERO-WHATSAPP]
type=registration
transport=transporte-udp
outbound_auth=NUMERO-WHATSAPP
server_uri=sip:sip.chatbots.net.br:5060
client_uri=sip:NUMERO-WHATSAPP@sip.chatbots.net.br
contact_user=NUMERO-WHATSAPP
endpoint=NUMERO-WHATSAPP
line=yes
retry_interval=60
forbidden_retry_interval=600
expiration=3600
max_retries=10000

[NUMERO-WHATSAPP]
type=endpoint
transport=transporte-udp
context=rota_entrada_inicial
disallow=all
allow=alaw
aors=NUMERO-WHATSAPP
from_user=NUMERO-WHATSAPP
from_domain=sip.chatbots.net.br
outbound_auth=NUMERO-WHATSAPP
identify_by=request_uri ; NAO coloque "auth=" aqui: equivale ao insecure=invite
deny=0.0.0.0/0.0.0.0
permit=186.232.110.43/255.255.255.255
force_rport=yes
rtp_symmetric=yes
rewrite_contact=yes
direct_media=no
dtmf_mode=rfc4733
send_rpid=yes
trust_id_inbound=yes
trust_id_outbound=yes
100rel=no
timers=no


[NUMERO-WHATSAPP]
type=aor
qualify_frequency=30
contact=sip:sip.chatbots.net.br:5060


[NUMERO-WHATSAPP]
type=auth
auth_type=userpass
username=NUMERO-WHATSAPP
password=SEU_TOKEN


[NUMERO-WHATSAPP-identify]
type=identify
endpoint=NUMERO-WHATSAPP
match_request_uri=/^sip:NUMERO-WHATSAPP@/

7. Aplicando as Configuracoes

Apos editar os arquivos, reinicie o Asterisk:

asterisk -rx "sip reload"
asterisk -rx "dialplan reload"

# Ou reinicio completo:
asterisk -rx "core restart now"

8. Verificando o Status

Para verificar se o tronco esta registrado:

asterisk -rx "sip show peer NUMERO-WHATSAPP"
asterisk -rx "sip show registry"

Voce deve ver o status OK e o ping em ms.

9. Testando Chamadas

Receber: Peca para alguem ligar para seu WhatsApp. O Asterisk deve receber a chamada no contexto rota_entrada_inicial e tocar no ramal 6000.

Fazer: Para chamadas de saida, crie uma rota no seu dialplan apontando para o tronco [NUMERO-WHATSAPP].

asterisk -rvvv
# Voce vera os logs das chamadas em tempo real

10. Troubleshooting

Problema	Solucao
Tronco offline	Verifique se o QR Code foi escaneado no WhatsApp. Verifique a conectividade com sip.chatbots.net.br na porta 5060/UDP.
Chamada nao completa	Verifique se o codec alaw esta habilitado dos dois lados. Verifique NAT e firewall.
Audio ruim	Verifique latencia da rede. Mantenha apenas o codec alaw.
Registro falha	Confira username (numero WhatsApp) e secret (token). Ambos sao case-sensitive.
Sem audio	Verifique directmedia=no e nat=force_rport,comedia no sip.conf.

11. Suporte

Email: contato@chatbots.net.br
WhatsApp: 551131357414
Telegram: @chatbotsnet