Este guia mostra como integrar seu Agente de IA do Quickchat AI ao WhatsApp. O processo tem 2 etapas simples:
- Etapa 0: Pré-requisitos.
- Etapa 1: Conectar o WhatsApp.
Se precisar de ajuda, consulte Solução de problemas e perguntas frequentes ou entre em contato.
Assista ao vídeo
Etapa 0: Pré-requisitos
A. Número comercial
Escolha qual número de telefone usará no WhatsApp. Leia a documentação do WhatsApp ou as respostas abaixo.
Qual número pode ser usado na WhatsApp Cloud API?
- Você precisa de um número comercial dedicado que receba SMS ou chamadas de voz para verificação.
- O número deve ser válido, pertencer a você e incluir os códigos do país e da região.
Posso usar um número que já está no WhatsApp Messenger?
- Não. Você pode continuar usando chamadas e SMS, mas não o WhatsApp Messenger nesse número.
- Se ele já estiver no Messenger, exclua primeiro esse registro. Não se esqueça de fazer backup das conversas.
- Números banidos precisam ser desbloqueados antes do registro.
Posso usar um número do aplicativo WhatsApp Business?
- Sim. Se estiver no WhatsApp Business App, talvez seja possível conectá-lo à Cloud API sem excluir a conta do aplicativo. Consulte a documentação da Meta sobre cadastro com Coexistence.
Posso usar um número novo?
- Sim. Se preferir não usar o atual, obtenha um novo número, com chip físico ou número virtual. Serviços como Hushed vendem números virtuais.
B. Informações da empresa
Tenha estes dados prontos para informar no fluxo da Meta:
- Nome da empresa.
- Site da empresa.
- Categoria da empresa.
- Descrição da empresa.
Mesmo que alguns campos pareçam opcionais, preencha corretamente. Dados ausentes ou incorretos podem atrasar a aprovação ou causar restrições na conta.
Etapa 1: Conectar o WhatsApp
Após nossa atualização mais recente, a conexão começa com um clique. Não existe mais uma segunda etapa separada: o assistente Embedded Signup da Meta orienta a criação ou seleção da conta WhatsApp Business e do número. O Quickchat AI conclui o restante.
Abra o aplicativo Quickchat AI → External Apps → WhatsApp, clique em Connect WhatsApp e siga o pop-up da Meta:
- Entre na conta Meta, ou Facebook.
- Revise as permissões para o Quickchat AI, incluindo acesso à conta WhatsApp Business e ao portfólio empresarial, e continue.
- Informe os dados corretos: Business Portfolio, Business Name, Business Website, Country e demais campos.
- Crie ou selecione sua conta WhatsApp Business.
- Escolha o nome de exibição e a categoria do WhatsApp Business.
- Adicione o número comercial e verifique por SMS ou chamada, conforme solicitado.
- Clique em Confirm para conceder ao Quickchat AI o acesso necessário.
- Quando a Meta confirmar a conclusão, clique em Finish. O pop-up mostra uma confirmação do Quickchat AI de que sua conta WhatsApp foi conectada e fecha automaticamente.
No aplicativo, o painel mostra Connecting your WhatsApp account e muda para Connected em cerca de 30 segundos. Caso contrário, clique em Refresh Status. Se o problema persistir, confira os Pré-requisitos, o número e as informações da empresa.
Pronto, seu agente está no ar! 🎉 Os clientes já podem enviar mensagens ao número e receber respostas automáticas.
Para testar, envie uma mensagem de texto pelo WhatsApp ao número conectado. O agente deve responder e a conversa deve aparecer na Inbox do Quickchat AI. Se alguma etapa da Meta ficar incompleta, o Quickchat AI também envia ao proprietário da conta um lembrete por e-mail com os passos restantes.
Solução de problemas e perguntas frequentes
Como funciona o preço da WhatsApp Business API?
- Respostas a consultas recebidas, iniciadas pelo usuário, são Service messages. Elas permitem atender solicitações por uma pessoa ou por um bot de IA.
- A mensagem do usuário abre uma janela de atendimento de 24 horas, na qual respostas de serviço são gratuitas. A janela reinicia a cada nova mensagem do usuário.
- Fora das 24 horas, use Message Templates aprovados, como Marketing, Utility e Authentication, pagando por mensagem segundo as tarifas do WhatsApp.
- A Meta categoriza as conversas e calcula as cobranças. Mantenha um método de pagamento válido na sua conta WhatsApp Business para mensagens iniciadas pela empresa ou enviadas com modelos.
O botão Connect WhatsApp não funciona e o pop-up da Meta não aparece.
- Se o navegador bloquear o pop-up, o aplicativo pede que você o permita. Desative bloqueadores de pop-ups e rastreadores, atualize e tente novamente. Se necessário, use outro navegador.
A verificação do número falhou.
- Confirme que ele recebe SMS ou chamadas e não está preso a um registro que a Meta não permite coexistir. Se estiver no Business App, tente o cadastro por Coexistence.
A Meta diz que a configuração está incompleta ou o painel mostra um aviso.
- Clique em Reconnect WhatsApp. Isso resolve a maioria dos casos.
- Se não resolver, o número pode estar conectado a outro provedor. A Meta permite apenas um parceiro por conta WhatsApp de cada vez. Siga as instruções para adicionar o Quickchat AI como parceiro nas configurações Meta Business e clique em Refresh Status.
Conectei a conta errada.
- Clique em Reconnect no painel e repita o fluxo com as contas Meta Business e WhatsApp corretas.
As mensagens não aparecem na Inbox do Quickchat AI.
- Confirme que o pop-up mostrou a confirmação final da conexão.
- Verifique se a WhatsApp Account correta foi conectada e o AI Agent certo está selecionado.
- Se enviar após 24 horas sem nova mensagem do usuário, use modelos aprovados e configure um método de pagamento no WhatsApp Manager.
As respostas da IA não estão sendo enviadas no WhatsApp.
- O Quickchat AI mostra “WhatsApp replies are failing” no painel e uma notificação no dashboard. Soluções comuns: conclua a aprovação do nome de exibição no WhatsApp Manager; se a conexão expirou ou foi revogada, clique em Reconnect; se a Meta restringiu seu número por qualidade ou política, consulte o status no WhatsApp Manager. O alerta desaparece após uma resposta ser enviada com sucesso.
Modelos ou mensagens iniciadas pela empresa falham.
- Confira se os Message Templates estão aprovados e o método de pagamento está ativo no WhatsApp Manager.
- Novos remetentes começam com limites de mensagens, que aumentam conforme qualidade e verificação. Consulte as orientações da Meta sobre Messaging Limits se atingir os limites de mensagens iniciadas pela empresa.
- Confira messaging limits e quality rating no WhatsApp Manager se houver limitação de entrega.
Como criar meu próprio link do WhatsApp e um botão “Chat on WhatsApp”?
Como criar um código QR do WhatsApp?
- Abra WhatsApp Manager → Phone numbers, selecione seu número comercial e vá a Message links → Create Message Link.
- Você também pode encontrá-lo no aplicativo móvel WhatsApp Business. Veja este tutorial.
Precisa de ajuda?
Converse com a Support AI do Quickchat no WhatsApp:
📱 +1 302-405-9992: Iniciar conversa
Ou escaneie o código QR:
