Conectar sua conta WhatsApp Business no Rishi é o que destrava todo o resto: a partir desse momento o número está vinculado à API Oficial da Meta e pronto pra disparar mensagens automaticamente em eventos da sua loja.
A boa notícia: o Rishi usa o Embedded Signup, fluxo oficial da Meta. Você não precisa criar app no Facebook for Developers, gerar tokens manualmente, mexer em webhook URL no painel da Meta, nada disso. Você clica, autoriza, e o Rishi cuida do resto.
Pré-requisitos
Antes de começar, garanta:
- Conta no Facebook Business Manager ativa. Se você ainda não tem, crie uma — é gratuito e leva poucos minutos.
- Um número de telefone que você administra. Como o Rishi usa o Embedded Signup oficial da Meta e somos parceiros Meta, o mesmo número que está rodando no aplicativo WhatsApp Business continua funcionando lá em paralelo — você não precisa deletar nada. Os dois coexistem: o app segue pra atendimento humano e a API roda os disparos automáticos.
- Acesso ao número pra receber código de verificação (SMS ou ligação) durante a configuração, caso a Meta peça.
Coexistência funciona pra contas WhatsApp Business comuns. Se o número já está em uso em outra API Oficial (de outro provedor de WhatsApp), aí sim é preciso migrar a numeração. Fale com nosso time que a gente conduz a migração pra você.
Conectando passo a passo
- Acesse o Rishi e vá em API Oficial → Conexões.
- Clique em Nova conexão. Vai abrir o modal oficial do Facebook em cima da tela.
- Faça login com a conta Facebook que administra o seu Business Manager (se ainda não estiver logado).
- Selecione o Business Manager que você quer usar. Se você administra mais de um, escolha o da sua loja.
- Selecione ou crie a Conta WhatsApp Business (WABA). Esse é o "container" que vai abrigar seu número na infraestrutura da Meta. A maioria dos lojistas cria uma nova com o nome da loja.
- Selecione ou cadastre o número de telefone. Se for um número novo no Business, a Meta pode pedir o código de verificação por SMS ou voz.
- Defina o nome de exibição — esse é o nome que seus clientes vão ver no WhatsApp. Use o nome da loja como ele aparece pro público.
- Autorize o Rishi a gerenciar mensagens, templates e webhooks dessa conta.
- O modal fecha sozinho. A conexão aparece na sua lista com o status verde.
Pronto. Daqui em diante o seu número está rodando na API Oficial.
O que acontece nos bastidores
Pra você não precisar lembrar disso, mas pra ficar claro o que o Rishi faz pra você:
- Troca a autorização do Embedded Signup por um token de longa duração com a Meta.
- Registra os webhooks da Meta apontando pra um endpoint do Rishi (é assim que recebemos status de entrega, leitura, respostas).
- Faz o registro do número na API (configura PIN de duas etapas e certifica o telefone pra envio).
- Provisiona uma caixa de entrada no atendimento conversacional, caso você queira ver e responder mensagens recebidas dentro do Rishi.
Como saber que deu certo
Depois de conectar, você consegue:
- Ver a conexão na lista com bolinha verde e o nome do número.
- Acessar a aba Templates dentro da conexão e ver (ou criar) os modelos de mensagem aprovados pela Meta.
- Mandar um template de teste pro seu próprio WhatsApp pra confirmar que tudo está fluindo.
Mande um teste pro seu número antes de configurar disparos automáticos. Em Templates, escolha um template existente e use o botão de envio de teste. Se chegou no seu WhatsApp, está tudo certo.
Erros comuns
"Esse número já está em uso em outra API Oficial" — outro provedor de WhatsApp API está com esse número registrado. Pra migrar pra cá, fale com o nosso time que conduzimos o processo (envolve liberar o número no provedor anterior).
"Você não tem permissão pra gerenciar essa conta" — sua conta Facebook não é admin do Business Manager selecionado. Peça pra quem é admin te dar acesso ou conecte com outra conta.
"Falha ao trocar code por token" — pode ser problema momentâneo da Meta. Aguarde alguns minutos e tente de novo. Se persistir, abra um chamado.
Próximos passos
Com o número conectado, você precisa decidir de onde os eventos vão vir pra disparar suas mensagens:
- Sua loja é WooCommerce? Vá pra Instalando o plugin Automações para WhatsApp no WooCommerce. É o caminho mais rápido — em poucos minutos você tem mensagem automática em pedido novo, mudança de status, código de rastreio etc.
- Outro sistema (ERP, plataforma própria, Shopify, etc)? Veja Recebendo eventos de outros sistemas via webhook.
E quando for hora de criar a primeira mensagem, dê uma passada em Como criar templates que convertem — vale o tempo.