Conectando o WhatsApp Business

A integração com o WhatsApp Business permite gerenciar conversas do WhatsApp diretamente na caixa de entrada do Deskwoot, centralizando todas as interações com clientes em um só lugar. O Deskwoot utiliza a API oficial do WhatsApp Cloud fornecida pela Meta, que não tem custo de configuração. Abaixo você encontra tudo o que precisa para conectar, além de dicas para evitar os erros mais comuns.

Requisitos

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

Conexão Rápida (Recomendado)

A forma mais rápida de conectar é pelo botão Connect WhatsApp via Facebook:

1. Acesse Settings > Inboxes > Add Inbox > WhatsApp.
2. Clique em Connect WhatsApp via Facebook.
3. Faça login na sua conta Meta Business.
4. Selecione ou crie uma conta WhatsApp Business e verifique seu número de telefone.
5. O Deskwoot cuida do restante automaticamente, incluindo a configuração do webhook.

Configuração Manual

Para a configuração manual, você vai precisar de três valores do seu painel de desenvolvedores da Meta:

• Phone Number ID — encontrado nas configurações do WhatsApp dentro do seu app.
• Token de Acesso Permanente — crie um System User nas configurações do Meta Business e gere um token com as permissões necessárias do WhatsApp.
• Verify Token — qualquer string que você escolher (ex.: my-deskwoot-verify-token).

Insira os três valores nas configurações da caixa de entrada do WhatsApp no Deskwoot e salve.

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 e o verify token no Deskwoot.
2. Cole nas configurações de webhook do WhatsApp no seu Meta App.
3. Inscreva-se no campo de webhook messages.

Templates de Mensagem

O WhatsApp exige templates de mensagem pré-aprovados para mensagens enviadas fora da janela de atendimento de 24 horas. Crie os templates no Meta Business Manager e depois use-os pelo Deskwoot ao iniciar novas conversas ou reengajar clientes após o encerramento da janela.

Solução de Problemas

• Número de telefone já em uso: Remova o número do app WhatsApp ou WhatsApp Business antes de conectar. Um número só pode estar registrado em uma plataforma por vez.
• Mensagens não chegam no Deskwoot: Verifique se a URL do webhook está correta e se o campo messages está inscrito nas configurações do seu Meta App.
• Token de acesso expirado: Se você usou um token temporário na configuração manual, gere um permanente por meio de um System User. 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 templates de mensagem concisos e personalizados — a Meta analisa cada template, e uma linguagem clara e não promocional é aprovada mais rapidamente.
• Responda dentro da janela de atendimento de 24 horas para evitar a necessidade de usar um template a cada resposta.

Perguntas Frequentes

A WhatsApp Cloud API tem algum custo?

A configuração da API é gratuita. No entanto, a Meta cobra taxas por conversa com base na categoria da conversa e no país. Consulte a página de preços da Meta para ver as tarifas atuais.

Posso usar meu número pessoal do WhatsApp?

Pode, mas o número precisa ser desvinculado do app WhatsApp ou WhatsApp Business antes. Uma vez conectado à API, você não poderá mais usar esse número no app do celular.

Posso conectar vários números de WhatsApp?

Sim. Crie uma caixa de entrada separada no Deskwoot para cada número, repetindo o processo de configuração em Settings > Inboxes > Add Inbox > WhatsApp.