WhatsApp

Este guia mostra como integrar seu Quickchat AI Agent ao WhatsApp. O processo é dividido em 2 etapas simples:

• Etapa 0 – Pré-requisitos
• Etapa 1 – Conectar WhatsApp

Se tiver problemas durante a integração, consulte Solução de problemas e FAQ ou entre em contato conosco.

Assista ao vídeo

Play

Etapa 0 – Pré-requisitos

A. Número de telefone comercial

Defina qual número de telefone você usará no WhatsApp. Leia mais na documentação do WhatsApp ou verifique as FAQs abaixo:

Qual número pode ser usado na WhatsApp Cloud API?

• Use um número comercial dedicado que possa receber SMS ou chamadas de voz para verificação.
• O número precisa ser válido, de sua propriedade e ter código do país e da área.

Posso usar um número que já esteja no WhatsApp Messenger?

• Não. Você pode continuar usando-o para chamadas e SMS, mas não no WhatsApp Messenger.
• Se o número já estiver no Messenger, remova-o primeiro. Lembre-se de fazer backup do histórico de conversas.
• Números banidos precisam ser desbloqueados antes do registro.

Posso usar um número que já está no aplicativo WhatsApp Business?

• Sim. Se o número estiver em uso no aplicativo WhatsApp Business, geralmente é possível migrá-lo para a Cloud API sem excluir a conta do aplicativo. Veja a documentação da Meta sobre onboarding por Coexistence.

Posso usar um novo número?

• Sim. Se não quiser usar seu número atual, adquira um novo número (SIM físico ou número virtual). Serviços como Hushed vendem números virtuais.

B. Informações da empresa

Tenha os seguintes dados em mãos (serão usados no fluxo de integração da Meta):

• Nome da empresa
• Site da empresa
• Categoria da empresa
• Descrição da empresa

Cuidado

Mesmo que pareçam opcionais, preencha todos os campos com precisão. Informações incorretas ou ausentes podem atrasar a aprovação ou gerar restrições.

Etapa 1 – Conectar WhatsApp

Abra o Quickchat AI App → External Apps → WhatsApp → clique no botão Conectar WhatsApp e siga o pop-up da Meta:

1. Faça login na sua conta Meta (Facebook).
2. Revise as permissões que você compartilhará com o Quickchat AI (acesso à conta do WhatsApp Business e acesso ao portfólio empresarial) e continue.
3. Forneça dados empresariais corretos (Business Portfolio, Business Name, Business Website, país etc.).
4. Crie ou selecione sua conta WhatsApp Business.
5. Escolha um nome de exibição e uma categoria para o WhatsApp Business.
6. Adicione seu número comercial e verifique-o via SMS/ligação, conforme solicitado.
7. Clique em Confirm para conceder os acessos necessários ao Quickchat AI.
8. Quando a Meta confirmar que a configuração foi concluída, clique em Finish. O pop-up exibirá uma confirmação do Quickchat AI informando que a conta do WhatsApp foi conectada, e a janela será fechada automaticamente.

De volta ao Quickchat AI App, o painel do WhatsApp mudará para Conectado em cerca de 30 segundos. Se isso não acontecer, clique no ícone de atualizar no painel. Caso contrário, revise os Pré-requisitos acima e confirme que você forneceu corretamente seu número comercial e as informações da empresa.

Pronto, você está no ar! 🎉 Clientes já podem enviar mensagens para seu número do WhatsApp e o AI Agent responderá automaticamente.

Dica

Como verificação final, envie uma mensagem para o número do WhatsApp recém-conectado. Você deve receber a resposta do AI Agent e a conversa aparecerá na caixa de entrada do Quickchat AI App. Na mesma caixa, haverá uma mensagem do WhatsApp com um link para Setup guidance no WhatsApp Manager. Siga o link para concluir o onboarding. Se você deixar alguma das etapas de configuração da Meta incompleta, o Quickchat AI também envia por e-mail ao proprietário da conta as etapas restantes como lembrete.

Troubleshooting & FAQs

Como funciona a precificação da WhatsApp Business API?

• Respostas a solicitações iniciadas pelo usuário (inbound) são tratadas como Service messages pelo WhatsApp. Elas permitem atender clientes via agente humano ou bot conversacional.
• Quando um usuário envia mensagem para a empresa, abre-se uma janela de atendimento de 24 horas em que é possível responder com mensagens de serviço sem custo. Essa janela reinicia a cada mensagem do usuário.
• Após 24 horas, é obrigatório usar Message Templates aprovados (Marketing, Utility, Authentication etc.) e pagar por mensagem conforme as tarifas da plataforma WhatsApp Business.
• As conversas são classificadas e faturadas pela Meta. Garanta que sua conta WhatsApp Business tenha um método de pagamento válido para mensagens iniciadas pela empresa/templated.

O botão Conectar WhatsApp não funciona. O pop-up da Meta não aparece.

• Se o navegador bloquear o pop-up, permita pop-ups para o Quickchat AI App e clique em Tentar novamente. Você também pode clicar em Continuar no Meta nesta aba para concluir a mesma configuração sem um pop-up.

A Quickchat não conseguiu confirmar a conexão com o WhatsApp

A Quickchat mostra esta mensagem de recuperação quando a janela da Meta não retorna nenhum resultado e ainda não consegue verificar a conexão. Isso não significa que a Meta não tenha feito alterações.

1. Confirme que você é administrador da empresa na Meta que possui a conta do WhatsApp Business. Caso não seja, peça a um administrador para conectá-la usando a conta dele no Facebook.
2. Clique em Tentar novamente. Se um bloqueador interferir na janela da Meta, use uma janela privada com as extensões desativadas ou clique em Continuar no Meta nesta aba.
3. Se o número estiver ativo no WhatsApp Messenger, remova-o primeiro desse aplicativo ou use outro número. Se estiver ativo no aplicativo WhatsApp Business, siga o onboarding por Coexistence da Meta.
4. Se a conta do WhatsApp Business usa Aircall, Twilio, 360dialog, MessageBird ou outro provedor, adicione a Quickchat AI como parceira no Meta Business Settings:
   1. Abra o Meta Business Settings e acesse Contas → Contas do WhatsApp.
   2. Selecione a conta do WhatsApp Business, abra Parceiros e clique em Adicionar parceiros.
   3. Insira o Business ID da Quickchat AI: 270696274483463.
   4. Conceda a permissão Gerenciar contas do WhatsApp, volte para a Quickchat AI e atualize o status.

Desconecte o outro provedor somente se a Meta não permitir ambos os parceiros nessa conta. Se tiver dúvidas, entre em contato com o suporte antes de desconectar um provedor de mensagens ativo.

A verificação do número falhou.

• Confira se o número recebe SMS/ligação e se não está preso em outro fluxo de registro que a Meta não permita coexistir. Se o número estiver no aplicativo Business, tente o onboarding por Coexistence.

Conectei a conta errada.

• Clique em Reconectar no painel do WhatsApp e repita o fluxo usando a conta correta do Meta Business e a conta certa do WhatsApp.

As mensagens não aparecem na caixa de entrada do Quickchat AI.

• Confirme se o pop-up exibiu o aviso final “WhatsApp account connected!”.
• Verifique se você vinculou a conta do WhatsApp correta e selecionou o AI Agent certo.
• Ao enviar mensagens depois de 24 horas sem resposta do usuário, use templates aprovados e confirme se há um método de pagamento ativo no WhatsApp Manager.

As respostas do WhatsApp do meu AI estão a falhar ao enviar.

Se as respostas do seu AI não puderem ser entregues, o Quickchat AI exibe um aviso “As respostas do WhatsApp estão a falhar” no painel do WhatsApp em External Apps e uma notificação no seu dashboard. As causas e soluções mais comuns:

• Aprovação do nome de apresentação pendente: A Meta exige a aprovação do nome de apresentação do seu número de WhatsApp antes de enviar respostas. Conclua-a no WhatsApp Manager e depois envie uma mensagem de teste.
• Conexão expirada ou revogada: sua conexão do WhatsApp já não é válida. Abra o painel do WhatsApp e clique em Reconectar para retomar o envio de respostas.
• Número restrito: A Meta restringiu o seu número de WhatsApp (qualidade ou políticas). Verifique o estado no WhatsApp Manager para restaurar o envio.

O aviso desaparece automaticamente assim que uma resposta é enviada com sucesso novamente.

Templates ou mensagens iniciadas pela empresa falham.

• Garanta que seus Message Templates estejam aprovados e que exista um método de pagamento ativo no WhatsApp Manager.
• Novos remetentes começam com limites de envio que aumentam conforme a qualidade e a verificação. Se atingir um limite, consulte o guia da Meta sobre Messaging Limits.
• Acompanhe os limites e a classificação de qualidade no WhatsApp Manager caso as entregas sejam reduzidas.

Como criar seu próprio link do WhatsApp e botão “Conversar no WhatsApp”?

• Siga este tutorial do WhatsApp.
• Ou baixe os botões oficiais de marca do WhatsApp e utilize um destes scripts em linha:

<!-- Botão de WhatsApp embutido -->
<!-- Atualize WHATSAPP_PHONE_NUMBER e o nome/caminho do arquivo conforme necessário -->
<a
  aria-label="Conversar no WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Conversar no WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

ou

<!-- Botão flutuante do WhatsApp -->
<!-- Atualize WHATSAPP_PHONE_NUMBER e o nome/caminho do arquivo conforme necessário -->
<a
  aria-label="Conversar no WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Conversar no WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

Como gerar seu próprio código QR do WhatsApp?

• Acesse o WhatsApp Manager → Números de telefone → selecione seu número comercial → Links de mensagem → Criar link de mensagem.
• Alternativamente, você pode gerar no app móvel WhatsApp Business. Siga este tutorial do WhatsApp.

Se nos conectarmos por Coexistence, podemos desconectar mais tarde?

• Sim, a qualquer momento. No aplicativo WhatsApp Business, acesse Configurações → Conta → Plataforma empresarial → Desconectar.
• O número continua ativo no aplicativo WhatsApp Business, e seus contatos e o histórico de conversas existente não são afetados.
• O acesso da Quickchat AI à API termina imediatamente.
• Você também pode pausar a integração sem desconectá-la. Basta interromper as mensagens de saída da Quickchat AI.

Que acesso a Quickchat AI obtém à nossa conta do WhatsApp Business?

• Acesso restrito à API, não propriedade da conta. Sua conta do WhatsApp Business (WABA) fica no seu próprio Meta Business Manager. No modelo WABA Sharing da Meta, você possui os ativos, e a Quickchat AI é adicionada como uma parceira cujo acesso pode ser revogado a qualquer momento no Business Manager.
• Podemos enviar e receber mensagens pela Cloud API e receber eventos de mensagens via webhook enquanto a integração estiver ativa.
• Não podemos encerrar, transferir ou alterar a marca da sua conta, modificar o faturamento nem remover seus administradores.

Precisa de ajuda?

Converse com o Quickchat Support AI no WhatsApp:
📱 +1 302-405-9992 — Iniciar chat

Ou escaneie o QR code: