O WhatsApp Cloud API é o canal oficial da Meta para envio e recebimento de mensagens no WhatsApp. Conectar esse canal permite que você envie campanhas, receba conversas no inbox e use agentes de IA para atendimento automático. Este guia mostra como configurar a integração.
Disponível em: todos os planos.
Quem pode fazer: administradores (perfil SUPER_ADMIN).
O que você precisa antes de começar
Ter acesso de administrador à Nuvia (perfil SUPER_ADMIN)
Ter uma conta Meta Business verificada (business.facebook.com)
Ter um número de telefone dedicado para o WhatsApp (não pode estar vinculado a outro WhatsApp)
Ter os seguintes dados da sua conta Meta:
ID do número (Phone Number ID)
ID do negócio (Business ID)
ID do WABA (WhatsApp Business Account ID)
Token do negócio (Business Token)
💡 Dica: Esses dados estão disponíveis no painel de desenvolvedor da Meta (developers.facebook.com), na seção do WhatsApp Business API. Se precisar de ajuda para obter esses dados, entre em contato com o suporte da Nuvia.
Passo 1 — Acessar a configuração de canais
Clique no ícone do seu perfil no canto inferior esquerdo do menu lateral
Selecione Canais
Na tela de canais, clique em Criar inbox ou no botão de adicionar
Passo 2 — Selecionar o tipo de canal
No campo Canais, selecione WhatsApp (tipo: WhatsApp Cloud API / Auto Closer)
Preencha o campo Nome com um nome descritivo para identificar o canal (ex: "WhatsApp Comercial", "WhatsApp SDR")
Passo 3 — Preencher os dados da integração
No campo Número (DDI + DDD + Celular), insira o número completo do WhatsApp com código do país e área (ex: 5511999998888)
Preencha os campos de integração com os dados da Meta:
ID do número — o Phone Number ID do painel da Meta
ID do negócio — o Business ID da sua conta Meta Business
ID do Waba — o WhatsApp Business Account ID
Token do negócio — o token de acesso permanente (opcional, mas recomendado)
⚠️ Importante: Confira os IDs com atenção. Um ID incorreto impedirá o envio e recebimento de mensagens. Os dados podem ser copiados diretamente do painel de desenvolvedores da Meta.
Passo 4 — Configurar o Funil Inteligente padrão
No campo Funil padrão, selecione o Funil Inteligente que será acionado automaticamente quando um contato iniciar uma conversa por esse canal
Se você ainda não criou um Funil Inteligente, pode pular este passo e configurar depois
💡 Dica: Associar um Funil Inteligente ao canal permite que a IA responda automaticamente às mensagens recebidas, qualificando leads antes de transferir para um atendente humano.
Passo 5 — Salvar e ativar
Revise todos os campos preenchidos
Clique em Salvar
Aguarde a confirmação: "Inbox criado com sucesso."
Passo 6 — Configurar o webhook na Meta (obrigatório)
Após criar o canal na Nuvia, é necessário configurar o webhook no painel da Meta para que as mensagens cheguem à plataforma:
Acesse o painel de desenvolvedor da Meta (developers.facebook.com)
Vá até a seção WhatsApp > Configuração
Em Webhook, cole a URL de callback fornecida pela Nuvia
Insira o token de verificação fornecido pela Nuvia
Ative as assinaturas de mensagens (messages, message_templates)
⚠️ VERIFICAR COM PRODUTO: A URL de webhook e o token de verificação específicos para cada conta precisam ser confirmados. Consulte o suporte da Nuvia para obter esses dados.
Como saber se deu certo
✅ O canal aparece na lista de Canais com status de integrado (ícone verde de verificação)
✅ Na tela de Integrações (menu do perfil > Apps), o WhatsApp aparece com o botão Ver integrações e um ícone de check verde
✅ Você consegue receber uma mensagem de teste no inbox da Nuvia ao enviar uma mensagem para o número configurado
Próximos passos
Você conectou o WhatsApp Cloud API. Agora:
→ Como criar a primeira lista de contatos — importe contatos para começar a prospectar
→ Como criar e lançar a primeira campanha — envie sua primeira campanha via WhatsApp
→ Como configurar o primeiro Funil Inteligente — crie um agente de IA para atender automaticamente
Perguntas frequentes
Qual a diferença entre WhatsApp Cloud API e WhatsApp Business (Evolution API)?
O WhatsApp Cloud API é a API oficial da Meta, hospedada nos servidores da Meta, com alta confiabilidade e suporte a templates HSM aprovados. O WhatsApp Business via Evolution API é uma alternativa que utiliza a API não oficial, com mais flexibilidade para mensagens livres, mas sem as garantias de estabilidade da API oficial. Para campanhas em escala, recomendamos o WhatsApp Cloud API.
Posso conectar mais de um número de WhatsApp?
Sim. Cada número é configurado como um canal (inbox) separado. Repita o processo para cada número adicional que deseja conectar.
O que é o Funil padrão do canal?
É o Funil Inteligente (agente de IA) que será acionado automaticamente quando uma nova conversa chegar por esse canal. Ele é responsável pelo primeiro atendimento — qualificação, respostas automáticas e transferência para humanos quando necessário.
Preciso de um número de telefone novo?
Sim. O número usado para o WhatsApp Cloud API não pode estar vinculado a outra conta do WhatsApp (pessoal ou WhatsApp Business App). Você precisa de um número dedicado exclusivamente para a API.
O que acontece se o token da Meta expirar?
Se o token expirar, o envio e recebimento de mensagens será interrompido. Gere um novo token permanente no painel de desenvolvedores da Meta e atualize o campo Token do negócio nas configurações do canal na Nuvia.