Configurando o WhatsApp Business

A configuração do WhatsApp Business no Deskwoot usa a WhatsApp Cloud API oficial da Meta, cujo registro é gratuito: você conecta uma Conta Comercial da Meta, verifica um número de telefone e a caixa de entrada do WhatsApp Business passa a receber mensagens junto com seus outros canais. Ao conectar sua conta do WhatsApp Business ao Deskwoot, você gerencia conversas do WhatsApp junto com e-mail, chat ao vivo e outros canais em uma caixa de entrada única e unificada. O Deskwoot usa a WhatsApp Cloud API, que tem configuração gratuita pela Meta.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte preparado:

• Uma conta comercial da Meta em business.facebook.com
• Um número de telefone verificado que não esteja registrado no aplicativo móvel WhatsApp ou WhatsApp Business
• Um aplicativo do Facebook com o produto WhatsApp ativado no painel de desenvolvedor da Meta (só para a configuração manual)

Passo 1: obtenha suas credenciais de API

No seu painel de desenvolvedor da Meta, acesse as configurações do WhatsApp do seu aplicativo. Localize os seguintes valores:

1. ID do número de telefone (Phone Number ID)
2. Token de acesso. A Meta fornece um token temporário por padrão. Para uso em produção, gere um token permanente de usuário do sistema nas Configurações Comerciais da Meta, em Usuários do sistema.
3. App Secret (recomendado), em App Settings > Basic no seu aplicativo da Meta. O Deskwoot usa o App Secret para conferir se os webhooks recebidos vêm mesmo da Meta.

Copie essas credenciais e mantenha-as à mão para o próximo passo. Você também escolhe um Verify Token, qualquer texto que quiser.

Passo 2: conecte ao Deskwoot

1. No Deskwoot, vá em Configurações > Caixas de entrada > Adicionar caixa de entrada.
2. Selecione WhatsApp como o tipo de canal.
3. Abra Avançado: conectar manualmente com as credenciais do seu próprio app da Meta e informe Phone Number ID, Token de acesso, Verify Token e App Secret.
4. Clique em Criar caixa de entrada.

Depois abra WhatsApp > Configuration no seu aplicativo da Meta, cole a URL do webhook do Deskwoot mostrada na configuração, informe o mesmo Verify Token, clique em Verify and Save e assine o campo messages.

Mais rápido sem um aplicativo próprio da Meta: clique em Conectar com o WhatsApp, em Conectar com a Meta, escolha sua conta e seu número na janela da Meta, e o Deskwoot configura o webhook para você. Um número que já roda na Twilio se conecta com Conecte seu número da Twilio (Account SID, Auth Token, número do WhatsApp).

Passo 3: teste sua configuração

Envie uma mensagem de WhatsApp para o número conectado a partir de qualquer conta pessoal do WhatsApp. A mensagem deve aparecer como uma nova conversa na sua caixa de entrada do Deskwoot em poucos segundos. Tente responder pelo Deskwoot para confirmar que a troca de mensagens nos dois sentidos está funcionando corretamente.

Solução de problemas comuns

• Mensagens não chegam: verifique se o seu token de acesso não expirou. Tokens temporários duram apenas 24 horas. Mude para um token permanente de usuário do sistema para um serviço sem interrupções.
• Número de telefone já registrado: se o número estiver vinculado ao aplicativo móvel WhatsApp ou WhatsApp Business, você precisa excluí-lo do aplicativo antes de usá-lo com a Cloud API.
• Erros de webhook: certifique-se de que seu aplicativo da Meta esteja no modo Live, e não no modo de desenvolvimento, e de que o produto WhatsApp tenha sido adicionado corretamente ao seu aplicativo.

Boas práticas

• Use sempre um token permanente de usuário do sistema para evitar desconexões inesperadas.
• Configure regras de atribuição automática no Deskwoot para que as conversas recebidas do WhatsApp sejam encaminhadas para a equipe ou o agente certo.
• Lembre-se da janela de mensagens de 24 horas do WhatsApp. Você pode responder livremente dentro de 24 horas após a última mensagem do cliente. Depois disso, o WhatsApp só entrega modelos de mensagem aprovados, e o Deskwoot mostra um aviso na conversa em vez de enviar a sua resposta.

Perguntas frequentes