PABX IP com WhatsApp Business: a ligação cai na URA da UCM

Os passos abaixo seguem o guia oficial do tronco WhatsApp da Grandstream, atualizado em 05/10/2026, e a nota da versão 1.0.35.8. As telas da Meta mudam com frequência: se um botão estiver com outro nome, confira o guia.

Como a ligação do WhatsApp chega à UCM?

Na UCM, tronco é a porta por onde as ligações externas entram e saem: a linha da operadora, um chip de celular e, agora, o WhatsApp. Pelo diagrama do guia oficial, o caminho é este:

1. 1
   O cliente abre a conversa com a empresa no WhatsApp e toca no botão de ligar.
2. 2
   A plataforma de chamadas do WhatsApp, na nuvem da Meta, recebe a ligação.
3. 3
   A Meta repassa a chamada à UCM por SIP, o protocolo que abre e encerra as ligações pela internet, com criptografia TLS.
4. 4
   A UCM recebe a chamada pelo tronco WhatsApp e consulta a rota de entrada desse tronco.
5. 5
   A rota entrega a ligação ao destino que você escolheu: URA, fila, grupo de toque, ramal ou o app Wave.

O cliente liga pelo WhatsApp que já usa, sem app novo. Para a empresa, a chamada vira uma ligação da central: passa pela URA, entra na fila e aparece no relatório de chamadas (CDR) marcada como WhatsApp.

O que é preciso para receber ligação do WhatsApp na UCM?

• ✓Central UCM6300 ou UCM6300A (UCM6301, 6302, 6304 e 6308; UCM6300A, 6302A, 6304A e 6308A) no firmware 1.0.35.8 ou superior, que hoje está na página de firmware beta. Para atualizar, com vídeo: como atualizar a UCM.
• ✓Plano RemoteConnect válido. É o serviço de nuvem da Grandstream que dá à UCM um endereço público sem abrir portas no roteador. O guia não diz se o Basic, gratuito, serve; planos e limites estão no guia do ramal no celular com o Wave.
• ✓HTTPS com certificado válido. A UCM precisa ser alcançável pela internet por HTTPS, com certificado de uma autoridade certificadora (autoassinado não serve). O guia recomenda o endereço do RemoteConnect (algo como https://xxxx.a.gdms.cloud) para cumprir essa exigência da Meta.
• ✓Conta de desenvolvedor na Meta (Meta for Developers) e portfólio empresarial (Business Portfolio) com acesso de administrador.
• ✓Um número livre para a API do WhatsApp Business, a porta que liga o WhatsApp a sistemas. Ele não pode estar registrado em nenhuma conta do WhatsApp, pessoal ou do app Business, e precisa receber o código de verificação por SMS ou ligação.
• ✓O destino pronto: a URA ou a fila que vai atender.
• ✓Wave atualizado, se as ligações forem tocar no app: a página do firmware beta pede isso a quem usa o RemoteConnect.

Comece pelo número de teste que a Meta oferece no painel, como recomenda o guia.

Passo 1: prepare a integração, o número e o token na Meta

No fim desta parte, você terá três dados para a UCM: o número, o Phone Number ID (o código do número na Meta) e o token (a chave de acesso).

1. 1
   Em Meta for Developers, clique em Create App para criar o app de integração, dê um nome e, em Business messaging, escolha o caso de uso Connect with customers through WhatsApp. Selecione o portfólio e conclua.
2. 2
   No menu lateral, abra Use Cases (ícone de lápis) e clique em Customize no caso de uso do WhatsApp. Em Quickstart/API Setup, copie o Phone Number ID do número de teste.
3. 3
   No WhatsApp Manager, abra Phone Numbers, o número e Call settings. Ligue Allow voice calls e, em Developer settings, Use Session Initiation Protocol (SIP).
4. 4
   Em Meta Business Settings, vá a Users > System Users, clique em Add e crie um usuário de sistema (por exemplo, UCM-WhatsApp) com a função Admin.
5. 5
   Em Assign Assets, dê a esse usuário Full Control sobre o app de integração (aba Apps, Manage app) e sobre a conta WhatsApp Business (aba WhatsApp Accounts, Manage WhatsApp Business Accounts). Clique em Save Changes.
6. 6
   Clique em Generate token e escolha o app de integração, a validade e as permissões. Na tela mostrada no guia são cinco: business_management, manage_app_solution, whatsapp_business_manage_events, whatsapp_business_management e whatsapp_business_messaging.
7. 7
   Copie o token e guarde em lugar seguro: ele não aparece de novo.

Não use o token temporário da página API Setup: ele expira em até 24 horas e serve só para o primeiro teste.

Deu certo com o número de teste? Cadastre o de verdade: em API Setup, clique em Add phone number, informe nome de exibição e categoria do negócio, o número e a verificação (SMS ou ligação), e digite o código. Copie o Phone Number ID dele e ligue as chamadas desse número em Call settings, como no passo 3.

Passo 2: crie o tronco WhatsApp na UCM

1. 1
   Na interface web da UCM, vá a Extension/Trunk > WhatsApp Trunk e clique em Add.
2. 2
   Em Trunk Name, dê um nome que nenhum tronco VoIP use.
3. 3
   Preencha Phone Number (o mesmo número cadastrado na Meta), Phone Number ID e Token.
4. 4
   Para gravar todas as ligações do tronco, marque Auto Recording; as gravações ficam em CDR > Recording Files.
5. 5
   Clique em Save. A UCM consulta a Graph API, a interface de programação da Meta, confere os dados e vincula o serviço SIP. Com algum dado errado, ela não salva e mostra um erro.
6. 6
   Na lista de troncos WhatsApp, a coluna Trunk Status deve mostrar Available.

Para pausar o atendimento pelo WhatsApp sem perder a configuração, marque Disable This Trunk no tronco.

Passo 3: mande a ligação para a URA, a fila ou o ramal

Quem decide o destino é a rota de entrada (Inbound Route), o mesmo recurso das linhas da operadora; a lógica está no guia de rotas de entrada e saída. Cada tronco WhatsApp aceita uma só rota de entrada.

1. 1
   Vá a Extension/Trunk > Inbound Routes, escolha o tronco WhatsApp no seletor do canto superior direito e clique em Add.
2. 2
   Dê um nome à regra em Inbound Rule Name.
3. 3
   Em Default Destination (destino padrão), escolha para onde vai a ligação.
4. 4
   Clique em Save e em Apply Changes.

As opções de destino são, em geral, as mesmas de um tronco VoIP. As mais úteis: IVR, a URA (unidade de resposta audível, o menu do “digite 1 para vendas”), que se monta com o passo a passo da URA na UCM63xx; Queues, a fila (veja filas e captura na UCM63xx); Ring Group, o grupo de toque, que chama vários ramais; e Extension, um ramal. Com o ramal no app Wave, a ligação toca no celular do atendente: veja como usar o ramal no celular com o Wave.

Para testar: em API Setup, no campo To, cadastre o seu WhatsApp pessoal e envie a mensagem de teste. Na conversa que abrir, toque em ligar. A chamada deve chegar ao destino escolhido e aparecer no CDR como ligação de WhatsApp.

Se não funcionar, o que conferir?

Tronco WhatsApp na UCM: sintoma e onde conferir

No celular, deslize a tabela para o lado para ver todas as colunas.

Para quem vale a pena hoje?

• ✓Loja, clínica ou escritório que recebe muitas ligações pelo WhatsApp e quer tratá-las como as da linha fixa: URA, fila, gravação e relatório de chamadas.
• ✓Quem pode dedicar um número ao atendimento por voz no WhatsApp, ou abrir um número novo para isso.
• ✓Quem já tem UCM6300 ou UCM6300A com RemoteConnect e pode testar firmware beta fora do horário.

Ainda não vale para quem precisa manter o mesmo número no app WhatsApp Business, nem para quem não pode rodar firmware beta na central que atende os clientes.

E as mensagens do WhatsApp?

São outro recurso, com outro guia oficial. A integração de mensagens (WhatsApp Business Integration) leva as conversas do WhatsApp ao Wave Desktop, com chatbot opcional, desde o firmware 1.0.29.19 na UCM630x e na UCM630xA. Ela funciona só no Wave Desktop: o Wave Web e o Wave do celular não têm suporte. O tronco deste guia é o da ligação de voz.

Perguntas frequentes

Fontes oficiais (consultadas em 21/10/2026): Guia do tronco WhatsApp (05/10/2026)  ·  Nota da versão 1.0.35.8 (beta)  ·  Guia do Wave Mobile, seção WhatsApp Calling (06/10/2026)  ·  Manual da UCM630x, seção WhatsApp Trunk  ·  Integração de mensagens do WhatsApp

GUIA UCM GRANDSTREAM:
Ramal no celular com o Wave  ·  Migrar da UCM6200 para a UCM6300  ·  Segurança da UCM contra fraude  ·  Linha da operadora na UCM  ·  UCM6300 ou UCM6300A  ·  Do 3CX para a UCM