Pular para o conteúdo

Conectando o WhatsApp Business

CRMConexão: híbridoaceita múltiplas contasAtualizado em

Ver o que a Toca faz com o WhatsApp Business →

Em homologação

Abrir integrações no app

A conexão com o WhatsApp Business tem dois jeitos, no mesmo card. O principal é Entrar com a Meta: abre a janela da Meta, você entra com o Facebook do negócio, escolhe a conta e o número do WhatsApp da loja e volta à Toca, sem copiar senha nem chave. O outro é colar o token de usuário do sistema de um app seu na Meta, para quem já tem integração própria. Nos dois casos o número é o da sua loja: a Toca fala com os seus clientes por ele, e nunca pelo WhatsApp da Toca.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

A Meta não deixa ler conversas antigas pela API. A Toca vê as mensagens que chegam a partir da conexão (e, se o número está no app WhatsApp Business do celular e você aceitar compartilhar, o histórico recente do app). Ela guarda só as mensagens que ainda estão sem resposta, por 30 dias, e apaga tudo quando você desconecta.

Antes de começar

  • Tenha acesso de administrador ao portfólio do negócio na Meta (Meta Business Suite). Se o negócio ainda não tem portfólio, a janela da Meta cria um.
  • Se o número está no app WhatsApp Business do celular, ele continua funcionando depois da conexão (o que você responde pelo celular conta como respondido na Toca). Use o app na versão 2.24.17 ou mais nova e deixe-o aberto durante a conexão. Ao conectar, o app muda assim: as listas de transmissão ficam só para leitura; mensagens temporárias, de visualização única e a localização em tempo real são desligadas; os aparelhos conectados (WhatsApp Web, computador) se desconectam e podem ser conectados de novo, menos o WhatsApp para Windows e WearOS.
  • Número que está no WhatsApp comum (não Business) precisa passar para o app WhatsApp Business antes, ou você conecta um número novo (que sai do app do celular).
  • Pagamento: a Meta cobra as mensagens direto de você, por mensagem entregue. Cadastre um cartão no WhatsApp Manager (botão Adicionar forma de pagamento). Cada número tem 1.000 respostas grátis por mês dentro da janela de 24 horas; mensagens de modelo (fora da janela, como cobrança e lembrete) são cobradas pela categoria. Sem cartão, a Meta para de entregar depois das 1.000 grátis.
  • Permissão dos clientes: só mande mensagem para quem deu o número à loja e aceitou receber mensagens pelo WhatsApp (é regra da Meta).
  • Caminho para uma pessoa: quando a Toca responde por você, a Meta exige que o cliente tenha um jeito claro de falar com uma pessoa da loja. Deixe no perfil do WhatsApp um telefone, e-mail ou site de atendimento, e responda você mesmo quando o cliente pedir.

Passo a passo

  1. Acesse Configurações → Integrações na Toca.
  2. Localize o card WhatsApp Business e clique em Conectar.
  3. Entrar com a Meta (recomendado): clique no botão. Na janela da Meta, entre com o Facebook do negócio, aceite os termos, escolha o portfólio e a conta do WhatsApp e escolha ou cadastre o número (ou escolha conectar o app WhatsApp Business do celular e siga o código que aparece no app). Clique em Concluir. Se a conta tiver mais de um número, a Toca pergunta qual usar.
  4. Token de usuário do sistema (para quem tem app próprio na Meta): em Configurações do negócio → Usuários do sistema, crie um usuário, dê a ele acesso ao seu app e à conta do WhatsApp, gere o token com as permissões whatsapp_business_management e whatsapp_business_messaging, e no app marque o campo messages em WhatsApp → Configuração → Webhooks. No card, cole o token, o id da conta do WhatsApp (WABA) e, se a conta tiver mais de um número, o id do número. Clique em Salvar token. A Meta recomenda que parceiros conectem pelo botão da Meta: use o token só se precisar.
  5. O card passa a mostrar o número conectado.

O que a Toca acessa

Lê:

  • as conversas dos seus clientes que estão sem resposta (desde a conexão, por 30 dias): quem escreveu, desde quando, o que pediu e se ainda dá para responder com texto livre (janela de 24 horas) ou só com modelo aprovado;
  • os modelos de mensagem e o status de aprovação na Meta;
  • o número, o perfil do WhatsApp, os QR codes e os contatos bloqueados;
  • as métricas de entrega, leitura e custo das mensagens.

Altera, sempre com a sua aprovação (cada mensagem passa por um card):

  • responde e manda mensagens aos clientes: texto, imagem, documento, botões e modelos aprovados (como lembrete de pagamento);
  • manda cobrança com Pix, link de pagamento ou boleto gerados no seu meio de pagamento conectado à Toca;
  • marca mensagens como lidas;
  • cria e edita modelos de mensagem (que passam pela aprovação da Meta), o perfil, QR codes, bloqueios, listas de campanha, grupos e formulários.

A Toca não usa as suas conversas para treinar inteligência artificial, e nunca manda os dados do WhatsApp para outro endereço.

Manutenção da conexão

  • A conexão pelo botão da Meta não vence. Para tirar o acesso da Toca: em Configurações do negócio → Integrações → Apps conectados, remova o app da Toca; no celular (app WhatsApp Business), em Configurações → Conta → Plataforma Business → Desconectar conta. A Toca apaga as conversas guardadas e o card pede para reconectar.
  • O token de usuário do sistema vale até você revogar ou até a validade escolhida ao gerar. Quando vencer, gere outro e cole no card.
  • Para trocar de número, conecte de novo pelo botão da Meta. Cada número conectado aparece como uma conta no card.

Problemas comuns

  • "O botão Entrar com a Meta está desabilitado": a conexão pela Meta ainda está sendo liberada para a sua conta. Use o token ou fale com o suporte.
  • "Este número não é elegível ainda": a Meta pede mais uso do número no app WhatsApp Business antes de conectar. Continue usando e tente depois, ou use outro número.
  • "A mensagem não foi enviada" fora das 24 horas desde a última mensagem do cliente: fora dessa janela a Meta só aceita modelo aprovado. Peça à Toca para usar um modelo.
  • "As conversas antigas não aparecem": a Meta não entrega o passado. A Toca vê o que chega depois da conexão (e o histórico do app, se você aceitou compartilhar ao conectar).
  • "As mensagens pararam de sair": confira a forma de pagamento no WhatsApp Manager; sem cartão, a Meta para depois das 1.000 respostas grátis do mês.

Outras integrações de crm

Abrir integrações no app