Conectando o WhatsApp Business

Atualizado em 20 de out. de 20266 min de leitura
Português
Nesta página

Conecta seu número WhatsApp Business ao Deskwoot pra tratar conversas WhatsApp. Use o Conectar com a Meta pra entrar pela janela da própria Meta; gerenciamos setup do webhook automático. Ou setup manual com Phone Number ID + Permanent Access Token + Verify Token do dashboard developer Meta. WhatsApp Cloud API é grátis pra setup; Meta cobra por conversa baseado em categoria e país.

A integração com o WhatsApp Business permite gerenciar as conversas do WhatsApp direto da sua caixa de entrada do Deskwoot, mantendo todas as interações com clientes em um só lugar. O Deskwoot usa a API oficial WhatsApp Cloud, fornecida pela Meta, cuja configuração é gratuita. Abaixo, você encontra tudo o que precisa para se conectar, junto com dicas para evitar erros comuns.

Requisitos

  • Uma Conta Comercial da Meta (business.facebook.com)
  • Um número de telefone que ainda não esteja registrado no WhatsApp ou no aplicativo WhatsApp Business
  • Acesso à API do WhatsApp Business, disponível pela plataforma de desenvolvedores da Meta sem custo de configuração

Conexão rápida (recomendada)

A forma mais rápida de conectar é pelo Conectar com a Meta:

  1. Acesse Configurações > Caixas de entrada > Adicionar caixa de entrada > WhatsApp.
  2. Em Conectar com a Meta, clique em Conectar com o WhatsApp.
  3. Faça login na sua Conta Comercial da Meta.
  4. Selecione ou crie uma Conta do WhatsApp Business e verifique o seu número de telefone.
  5. O Deskwoot cuida do resto automaticamente, inclusive da configuração do webhook.

Configuração manual

Para a configuração manual, reúna três valores no seu painel de desenvolvedor da Meta:

  • ID do número de telefone. Encontrado nas configurações do WhatsApp do seu app.
  • Token de acesso permanente. Crie um Usuário do Sistema nas Configurações de Empresa da Meta e gere um token com as permissões necessárias do WhatsApp.
  • Token de verificação. Qualquer texto que você escolher (por exemplo, my-deskwoot-verify-token).

Na configuração do WhatsApp, abra Avançado: conectar manualmente com as credenciais do seu próprio app da Meta, informe os três valores e também o App Secret (recomendado, com ele o Deskwoot confere se os webhooks vêm mesmo da Meta) e clique em Criar caixa de entrada.

Já usa o WhatsApp pela Twilio? Clique em Conecte seu número da Twilio na configuração do WhatsApp e informe Account SID, Auth Token e o número do WhatsApp.

Configuração do webhook

Se você usou a conexão rápida, os webhooks são configurados automaticamente. Para a configuração manual:

  1. Copie a URL do webhook mostrada na configuração manual do Deskwoot.
  2. Cole-a nas configurações de webhook do WhatsApp no seu App da Meta, junto com o mesmo token de verificação que você informou no Deskwoot.
  3. Assine o campo de webhook messages.

Modelos de mensagem

Fora da janela de atendimento de 24 horas, o WhatsApp só entrega modelos de mensagem pré-aprovados. Crie os modelos no seu Gerenciador de Negócios da Meta, onde a Meta os revisa. O Deskwoot envia um modelo aprovado pelo conector do Meta Lead Ads quando um novo lead preenche o seu formulário. Quando a janela fecha, você escolhe um modelo aprovado e o envia direto da conversa, veja Envie modelos do WhatsApp depois da janela de 24 horas. Números conectados pelo Twilio não enviam modelos no Deskwoot.

Solução de problemas

  • Número de telefone já em uso: Remova o número do aplicativo WhatsApp ou WhatsApp Business antes de conectar. Um número só pode estar registrado em uma plataforma por vez.
  • Mensagens não chegam ao Deskwoot: Confira novamente se a URL do seu webhook está correta e se o campo messages está assinado nas configurações do seu App da Meta.
  • Token de acesso expirado: Se você usou um token temporário durante a configuração manual, gere um permanente por meio de um Usuário do Sistema. Tokens temporários expiram após 24 horas.

Boas práticas

  • Use o fluxo de conexão rápida sempre que possível para reduzir erros de configuração.
  • Mantenha seus modelos de mensagem curtos e personalizados. A Meta revisa cada modelo, e uma linguagem clara e não promocional é aprovada mais rápido.
  • Responda dentro da janela de atendimento de 24 horas para não precisar de um modelo para cada resposta.

Perguntas frequentes

Quick Connect ou setup manual: qual?
Quick Connect quando possível. Poupa 15 minutos de caçada no dashboard e reduz erros de configuração. Manual quando precisa de controle granular ou Quick Connect não funciona na sua região.
Quanto custa WhatsApp?
Setup é grátis (Meta cobre hosting WhatsApp Cloud API). Fees per-conversation valem: categorias utility / marketing / authentication / service têm taxas diferentes por país. Janela de service de 24 horas grátis pra replies em conversas de entrada.
O que é a janela de service de 24 horas?
Uma vez que cliente te manda mensagem, você tem 24h pra responder livremente. Depois, só pode re-engajar via message template aprovado. Fica dentro da janela pra conversa grátis.
E se meu número de telefone já está no WhatsApp?
Remove do WhatsApp / WhatsApp Business app primeiro. Um número só pode estar em uma plataforma de cada vez. Depois de registrado na API, você perde acesso ao app mobile pra esse número.
Posso usar meu número WhatsApp pessoal?
Pode, mas vai perder acesso ao app mobile nesse número permanentemente. Melhor prática: dedica um número separado pra uso business.
Como message templates funcionam?
Cria templates no Meta Business Manager → Templates. Meta revisa cada um pra aprovação (geralmente em 24h). Mantém curto, não-promocional e útil, porque taxas de aprovação correlacionam com utilidade.
Posso conectar múltiplos números WhatsApp?
Sim. Cada vira própria inbox Deskwoot: repete o setup em Configurações > Caixas de entrada > Adicionar caixa de entrada > WhatsApp. Útil pra setups multi-region ou multi-brand.
O bot funciona no WhatsApp?
Sim. O Fynn responde às conversas do WhatsApp como nos seus outros canais (a partir do plano Startup), inclusive mensagens de voz: o Deskwoot as transforma em texto antes, veja O Fynn e as mensagens de voz. Acima da primeira resposta dele, o cliente vê uma linha como "Fynn, o assistente de IA de Acme", para saber que uma IA está respondendo.
E as mídias do WhatsApp (fotos, voz, documentos)?
Imagens, áudios e mensagens de voz, vídeos, figurinhas, localizações e documentos chegam na conversa. Os agentes enviam arquivos de volta pelo editor: imagens até 5 MB, vídeo e áudio até 16 MB, documentos até 100 MB. No painel web, abaixo de mensagens de voz e outros áudios aparece a transcrição automática.
Por que meu token Meta está expirando?
Você usou um token temporário. Gera um permanente via System User em Meta Business Settings; esses não expiram. Com o Conectar com a Meta, o Deskwoot renova o acesso sozinho, e se isso falhar a inbox mostra Reconectar com a Meta.
Posso ver confirmações de entrega WhatsApp?
Sim. Cada mensagem de saída mostra status sent / delivered / read, espelhando o que você vê no app WhatsApp. Útil pra confirmar que mensagens chegaram ao cliente. Quando o WhatsApp não entrega uma resposta, aparece Falha na entrega. com o motivo do WhatsApp, e quando só falta um arquivo, um clique envia de novo só esse arquivo, veja Quando uma resposta não é entregue.

Este guia foi útil?

Continue lendo

Perguntar ao Fynn sobre este guia

Receba uma resposta curta deste guia e do resto da Central de Ajuda.

Ainda precisa de ajuda?

Fynn responde no chat a partir destes guias, e você também fala com a equipe por lá.

Enviar e-mail