Canais · Atualizado em 06/10/2026
Como conectar o WhatsApp ao Pipe
Conecte um número de WhatsApp a um fluxo informando as credenciais da Meta, ative um número já cadastrado e teste a conexão.
No Pipe, o WhatsApp é um canal do fluxo: você informa as credenciais do aplicativo da Meta e do número, e as mensagens recebidas passam a chegar ao atendimento desse fluxo. Este guia mostra a conexão de um número novo, o uso de um número já cadastrado, o teste e o que fazer quando o número fica indisponível.
Quando usar
Use este procedimento quando a Loja Girassol, por exemplo, quiser receber pedidos e dúvidas de clientes pelo número comercial do WhatsApp, ou quando precisar trocar o número ligado a um fluxo.
Pré-requisitos
- Permissão para gerenciar canais e acesso de configuração ao fluxo.
- Uma conta do WhatsApp Business já criada na Meta, com um número de telefone cadastrado nela.
- O ID da conta do WhatsApp, o ID do número de telefone, o Token de acesso e a Chave secreta do aplicativo, todos obtidos na Meta.
- Acesso ao aplicativo da Meta para colar, no final, a URL de callback e o token de verificação que o Pipe mostra.
Passo a passo
- No portal da Gestão, abra o fluxo que receberá as conversas.
- Clique em Canais e, na lista Canais de conversa, abra o cartão WhatsApp.
- Na aba Visão Geral, clique em Conectar WhatsApp.
- Na janela Conectar WhatsApp, preencha ID da conta do WhatsApp e ID do número de telefone.
- Preencha Token de acesso e Chave secreta do aplicativo. Os dois campos vêm ocultos; use o ícone de olho para conferir o que foi digitado.
- Se quiser, preencha Nome para identificar o canal. O campo é opcional.
- Clique em Conectar.
- Quando aparecer Canal conectado., copie a URL de callback e o Token de verificação e cadastre os dois na configuração de webhook do aplicativo na Meta.
- Clique em Concluir.
- Na aba Visão Geral, confira o número exibido em Seu chatbot está conectado ao número: e clique em Testar no WhatsApp para abrir uma conversa com ele.
Campos da janela de conexão
| Campo | Obrigatório | O que informar |
|---|---|---|
| ID da conta do WhatsApp | Sim | Identificador da conta do WhatsApp Business na Meta. |
| ID do número de telefone | Sim | Identificador do número que receberá as mensagens. Não é o número com DDD. |
| Token de acesso | Sim | Token gerado na Meta para o aplicativo. Fica oculto por padrão. |
| Chave secreta do aplicativo | Sim | Disponível nas configurações básicas do aplicativo na Meta. Fica oculta por padrão. |
| Nome para identificar o canal | Não | Nome interno para reconhecer o canal nas listas. |
Usar um número que já está no Pipe
Um número pode existir no Pipe sem estar ligado a nenhum fluxo, por exemplo depois de uma desconexão. Nesse caso:
- Na aba Visão Geral do canal, clique em Usar número já conectado. O botão só aparece quando há um número livre ou já ligado a este fluxo.
- Em Ativação do número, abra o seletor Escolher número.
- Escolha o número. Os que estão ligados a outro fluxo aparecem desabilitados, com a indicação "em uso por" e o nome do fluxo.
- Clique em Ativar número.
Se o número que você procura não aparece, use o link Volte e cadastre agora. para voltar à conexão manual.
Exemplo na Loja Girassol
A equipe de atendimento da Loja Girassol quer separar as conversas de vendas das conversas de pós-venda. Ela cria dois fluxos. No fluxo de vendas, conecta o número principal com Conectar WhatsApp. No fluxo de pós-venda, tenta usar o mesmo número e vê que ele aparece desabilitado, em uso pelo fluxo de vendas. Para mover o número, a equipe desconecta o canal no fluxo de vendas e o ativa no de pós-venda.
Resultado esperado
A aba Visão Geral mostra o número conectado. Mensagens enviadas a esse número chegam ao atendimento do fluxo, e o cartão WhatsApp na lista de canais passa a exibir Conectado.
Quando o número fica indisponível
A página consulta o estado do número. Quando há problema, ela troca a visão normal por um aviso:
| O que aparece | Significado | O que fazer |
|---|---|---|
| Ainda não é possível usar este número, com "Aguardando reautorização do WhatsApp." | A autorização do número precisa ser renovada. | Clique em Reconectar número e informe as credenciais de novo. |
| "Canal sem token de acesso: reconecte." | O canal está sem token. | Clique em Reconectar número. |
| "A Meta recusou a conexão. Confira a autorização e reconecte." | A Meta recusou as credenciais. | Confira a autorização na Meta e use Reconectar número. |
| "Canal sem WABA: reconecte." | O canal perdeu a conta do WhatsApp Business. | Use Reconectar número. |
| "A Meta não respondeu: tente novamente em instantes." | Falha temporária do lado da Meta. | Clique em Tentar novamente. |
| Este número está desligado | O canal foi desligado. | Verifique o canal na gestão de contas. |
Em Reconectar número, a janela abre como Atualizar conexão do WhatsApp, já com os dois identificadores preenchidos, e o botão de envio vira Salvar credenciais.
Desconectar o canal
- Na aba Visão Geral, clique em Desconectar canal.
- Na janela Quer mesmo desconectar o WhatsApp?, escreva o motivo em Escreva o motivo aqui.
- Marque Eu concordo com os resultados da desconexão.
- Clique em Desconectar WhatsApp.
Limitações
- Um fluxo comum conecta um canal por vez. Se ele já tem outro canal, a página avisa que é preciso desconectá-lo antes. Roteadores podem conectar tipos diferentes sem desligar o canal existente.
- A conexão é manual: o Pipe não abre um assistente de login da Meta.
- As abas Perfil da empresa e Configurações só ficam disponíveis com o número conectado.
Problemas comuns
- O número não aparece para seleção: ele está ligado a outro fluxo. A lista mostra o nome desse fluxo; desconecte lá primeiro.
- A conexão não conclui e a janela mostra um erro: revise os identificadores e as credenciais, sem espaços sobrando.
- Conectou, mas nenhuma mensagem chega: confira se a URL de callback e o token de verificação foram cadastrados no aplicativo da Meta.
- O botão Testar no WhatsApp está desabilitado: o Pipe não conseguiu identificar o número do canal; recarregue a página.
Próximos passos
Perguntas frequentes
Preciso de um fluxo para conectar o WhatsApp?
Sim. A conexão é feita dentro do fluxo, na página Canais, e cada número fica ligado a um fluxo por vez.
Posso usar um número que já está cadastrado no Pipe?
Sim. Quando existe um número livre, a tela mostra o botão Usar número já conectado. Números ligados a outro fluxo aparecem desabilitados, com o nome do fluxo que os usa.
O que acontece se eu desconectar o canal?
O fluxo para de responder nesse número e o vínculo é removido. O número continua cadastrado na Meta; para voltar a usá-lo, repita a conexão.
Onde encontro a chave secreta do aplicativo?
Nas configurações básicas do aplicativo na Meta, como informa a própria janela de conexão.
Esse artigo foi útil?
Obrigado pelo retorno!