Configuração do WhatsApp
Guia completo passo a passo para configurar o WhatsApp Business API e enviar mensagens automáticas de faturas e orçamentos
📱 Configuração do WhatsApp Business API
Configure o WhatsApp Business API através do Meta (Facebook) para enviar mensagens automáticas quando suas faturas e orçamentos forem enviados aos clientes.
Por que usar WhatsApp?
O WhatsApp é o canal de comunicação preferido dos brasileiros. Enviar faturas pelo WhatsApp aumenta significativamente as taxas de visualização e pagamento.
🎯 O que você vai configurar
Ao final deste guia, você terá:
- ✅ WhatsApp Business API configurado no Meta
- ✅ Template de mensagem aprovado pelo Meta
- ✅ Integração ativa no LinkPix
- ✅ Mensagens automáticas funcionando
📋 Pré-requisitos
Antes de começar, você precisa ter:
- Conta no Facebook/Meta
- Número de telefone válido (pode ser de teste inicialmente)
- Acesso ao Meta Business Suite
- Acesso ao Meta for Developers
🚀 Passo a Passo Completo
1. Criar Conta Meta Business
- Acesse business.facebook.com
- Clique em "Criar Conta" ou faça login se já tiver uma conta
- Preencha as informações da sua empresa:
- Nome da empresa
- Seu nome
- Email corporativo
- Confirme o email recebido
Use um email corporativo que você tenha acesso, pois precisará confirmar o cadastro.
2. Criar App no Meta for Developers
- Acesse developers.facebook.com
- Clique em "Meus Apps" (canto superior direito)
- Clique em "Criar App"
- Selecione o tipo de app:
- Escolha "Business" ou "Outro"
- Clique em "Próximo"
- Preencha os dados do app:
- Nome do App: Ex: "Minha Empresa - WhatsApp"
- Email de contato: Seu email
- Finalidade do App: Selecione conforme sua necessidade
- Clique em "Criar App"
O nome do app pode ser alterado depois, então não se preocupe em escolher o nome perfeito agora.
3. Adicionar Produto WhatsApp
- No painel do seu app, procure por "WhatsApp" na lista de produtos
- Clique em "Configurar" no card do WhatsApp
- Você será redirecionado para a configuração do WhatsApp Business API
Se não encontrar o WhatsApp na lista, tente procurar por "WhatsApp Business API" ou "Messaging".
4. Obter Credenciais de Acesso
Você precisará de duas informações importantes:
4.1. Token de Acesso
Para Teste (24 horas):
- Na seção "Token de acesso temporário", você verá um token
- Este token é válido por 24 horas e serve para testes
- Copie este token - você precisará dele mais tarde
Para Produção (60 dias):
- No painel do app, vá para "Ferramentas" → "Explorador de API do Graph"
- Selecione seu app
- Em "Token de Acesso", clique em "Gerar Token de Acesso"
- Selecione as permissões:
whatsapp_business_messagingwhatsapp_business_management
- Este token terá duração de 60 dias
4.2. Phone Number ID
- Na seção "Números de telefone", clique no número que você criou
- Você verá o "Phone number ID" (um número longo)
- Copie este ID - você precisará dele também
Guarde essas informações!
Você precisará do Token de Acesso e do Phone Number ID para configurar no LinkPix. Anote-os em local seguro.
5. Configurar Número de Telefone
Para Teste (Gratuito)
- O Meta fornece um número de teste gratuito
- Permite enviar mensagens para até 5 números verificados
- Ideal para testar a integração sem custos
Para Produção
- No WhatsApp Business API, vá para "Números de telefone"
- Clique em "Adicionar número de telefone"
- Insira o número que deseja usar (deve ser um número que você possui)
- Escolha o método de verificação:
- SMS: Receberá um código por SMS
- Ligação: Receberá uma ligação com código
- Insira o código recebido
- O número será verificado e estará pronto para uso
Você pode começar com o número de teste e migrar para produção depois que tudo estiver funcionando.
6. Criar Template de Mensagem (Recomendado)
Por que usar Templates?
- ✅ Funciona no modo de teste e produção
- ✅ Mensagens são entregues com mais confiabilidade
- ✅ Aprovado pelo Meta (necessário para produção)
- ✅ Melhor taxa de entrega
6.1. Acessar Gerenciador de Templates
- No Meta for Developers, vá para WhatsApp → Gerenciar → Gerenciar modelos
- Clique em "Criar modelo"
- Escolha "Começar"
6.2. Configurar Template
- Nome:
invoice_notification(apenas letras minúsculas, números e underscore) - Categoria: Selecione "Notificações"
- Idioma: Português (Brasil)
- Tipo: Texto
6.3. Corpo da Mensagem
Use este template para faturas:
Olá {{1}}!
📄 Fatura {{2}} - {{3}}
📋 Itens:
{{7}}
💰 Valor Total: {{4}}
📅 Vencimento: {{5}}
🔗 Acesse aqui: {{6}}Variáveis do Template:
{{1}}- Nome do Cliente{{2}}- Número da Fatura{{3}}- Nome da Empresa ⭐ Importante: multitenant - cada empresa aparece com seu próprio nome{{4}}- Valor Formatado{{5}}- Data de Vencimento{{6}}- URL da Fatura{{7}}- Itens/Serviços ⭐ Lista formatada de todos os itens ou serviços da fatura{{8}}- ID do Documento ⭐ ID/token do documento (apenas o identificador, sem a URL completa) - Use para botões do WhatsApp
💡 Dica Multitenant
A variável {{3}} permite que o mesmo template funcione para todas as empresas do sistema, mas cada uma aparece com sua própria identidade nas mensagens. Isso significa que você não precisa criar um template por empresa!
6.4. Salvar e Aguardar Aprovação
- Clique em "Enviar para revisão"
- Aguarde aprovação (pode levar algumas horas)
- Status aparecerá como "Aprovado" quando estiver pronto
A aprovação do template pode levar algumas horas. Enquanto isso, você pode continuar com a configuração no LinkPix usando mensagens de texto livre.
7. Configurar no LinkPix
Agora vamos conectar tudo no LinkPix:
Opção A: Configuração da Plataforma (Padrão para todos os times)
- Acesse Configurações → Configurações da Plataforma
- Preencha os campos:
- Token de Acesso: Cole o token que você copiou
- Phone Number ID: Cole o ID que você copiou
- Nome do Template (opcional):
invoice_notification
- Ative o toggle "WhatsApp Ativo"
- Clique em "Salvar"
Opção B: Configuração por Time (Prioridade sobre a plataforma)
- Acesse Configurações → Integrações
- Clique em "Adicionar Integração" ou "Configurar WhatsApp"
- Preencha os campos:
- Nome da Integração: Ex: "WhatsApp Principal"
- Token de Acesso: Cole o token que você copiou
- Phone Number ID: Cole o ID que você copiou
- Nome do Template (opcional):
invoice_notification
- Clique em "Salvar" ou "Testar Conexão"
Ordem de Prioridade
- Template configurado na integração do time (se existir)
- Template configurado na plataforma padrão (se existir)
- Mensagem de texto livre (se nenhum template estiver configurado)
8. Testar a Integração
- Após salvar, o sistema tentará validar a conexão
- Se tudo estiver correto, você verá uma mensagem de sucesso
- Para testar o envio:
- Crie uma fatura ou orçamento
- Associe um cliente que tenha WhatsApp cadastrado
- Envie o documento
- Verifique se a mensagem chegou no WhatsApp do cliente
Se a mensagem chegou, parabéns! Sua integração está funcionando perfeitamente! 🎉
📝 Exemplos de Templates
Template para Faturas
Nome do Template: invoice_notification
Corpo da Mensagem:
Olá {{1}}!
📄 Fatura {{2}} - {{3}}
📋 Itens:
{{7}}
💰 Valor Total: {{4}}
📅 Vencimento: {{5}}
🔗 Acesse aqui: {{6}}Exemplo de Mensagem Enviada:
Olá João Silva!
📄 Fatura FAT-0012 - Minha Empresa LTDA
📋 Itens:
• Consultoria (1x R$ 1.000,00) - R$ 1.000,00
• Desenvolvimento (10h R$ 50,00) - R$ 500,00
💰 Valor Total: R$ 1.500,00
📅 Vencimento: 15 de janeiro de 2025
🔗 Acesse aqui: https://app.linkpix.co/share/invoice/59bf3d78-059a-49ea-aed2-4fd6c304f6fcTemplate para Orçamentos
Nome do Template: quote_notification
Corpo da Mensagem:
Olá {{1}}!
📄 Orçamento {{2}} - {{3}}
📋 Itens:
{{7}}
💰 Valor Total: {{4}}
📅 Válido até: {{5}}
🔗 Acesse aqui: {{6}}Exemplo de Mensagem Enviada:
Olá Maria Santos!
📄 Orçamento ORC-0045 - Consultoria ABC
📋 Itens:
• Consultoria (1x R$ 2.000,00) - R$ 2.000,00
• Desenvolvimento (20h R$ 60,00) - R$ 1.200,00
💰 Valor Total: R$ 3.200,00
📅 Válido até: 20 de janeiro de 2025
🔗 Acesse aqui: https://app.linkpix.co/share/quote/abc123-def456-ghi789💰 Custos e Limitações
Modo de Teste (Gratuito)
- ✅ Permite enviar mensagens para até 5 números verificados
- ✅ Sem custos
- ✅ Token válido por 24 horas
- ❌ Limitado a testes
Modo de Produção
- ✅ Sem limite de números
- ✅ Token válido por 60 dias (renovável)
- ⚠️ Custos: O Meta cobra por mensagem enviada
- 💰 Preços aproximados (podem variar):
- Conversas iniciadas pelo usuário: Gratuitas (primeiras 1000/mês)
- Conversas iniciadas pela empresa: ~R$ 0,05 - R$ 0,15 por mensagem
- Mensagens de template: ~R$ 0,05 - R$ 0,15 por mensagem
Janela de Conversa
- Após o cliente enviar uma mensagem, você tem 24 horas para responder gratuitamente
- Após 24 horas, você precisa usar um template aprovado (pago)
🛠️ Solução de Problemas
Erro: "Token inválido"
- Verifique se o token não expirou (renove se necessário)
- Certifique-se de copiar o token completo, sem espaços
- Gere um novo token no Meta for Developers
Erro: "Phone Number ID inválido"
- Verifique se copiou o ID correto do número de telefone
- Certifique-se de que o número está verificado
Erro: "Número de telefone não encontrado"
- Verifique se o número está no formato correto (E.164: +5511999999999)
- Certifique-se de que o número está verificado no Meta
Mensagens não estão sendo enviadas
- Verifique se o cliente tem WhatsApp cadastrado no sistema
- Verifique se o número do cliente está no formato correto
- Verifique os logs do sistema para mais detalhes
- Certifique-se de que o template está aprovado (se estiver usando template)
Token expirou
- Gere um novo token no Meta for Developers
- Atualize o token nas configurações de integração
🔒 Segurança
Importante
- ⚠️ Nunca compartilhe seu token de acesso publicamente
- ⚠️ Mantenha seus tokens seguros e atualizados
- ⚠️ Use tokens de longa duração em produção
- ⚠️ Configure renovação automática de tokens quando possível
✅ Checklist de Configuração
Use este checklist para garantir que tudo está configurado:
- Conta Meta Business criada
- App criado no Meta for Developers
- Produto WhatsApp adicionado ao app
- Número de telefone configurado (teste ou produção)
- Token de acesso obtido
- Phone Number ID obtido
- Template criado e aprovado (opcional, mas recomendado)
- Integração configurada no LinkPix
- Teste de conexão bem-sucedido
- Teste de envio de mensagem realizado
- Cliente recebeu mensagem no WhatsApp
💡 Dicas
- Comece com o modo de teste para validar a integração antes de ir para produção
- Use números de teste inicialmente para evitar custos
- Monitore os custos no painel do Meta Business
- Configure alertas para quando o token estiver próximo de expirar
- Mantenha backups dos tokens em local seguro
- Use templates para melhor taxa de entrega e confiabilidade
📚 Recursos Adicionais
- Documentação Oficial do WhatsApp Business API
- Meta for Developers
- Meta Business Suite
- Preços do WhatsApp Business API
🆘 Precisa de Ajuda?
Se você encontrou algum problema ou tem dúvidas:
- Verifique a seção "Solução de Problemas" acima
- Consulte a documentação oficial do Meta
- Entre em contato com nosso suporte: suporte@linkpix.co
Última atualização: Janeiro 2025