LinkPix

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

  1. Acesse business.facebook.com
  2. Clique em "Criar Conta" ou faça login se já tiver uma conta
  3. Preencha as informações da sua empresa:
    • Nome da empresa
    • Seu nome
    • Email corporativo
  4. Confirme o email recebido

Use um email corporativo que você tenha acesso, pois precisará confirmar o cadastro.

2. Criar App no Meta for Developers

  1. Acesse developers.facebook.com
  2. Clique em "Meus Apps" (canto superior direito)
  3. Clique em "Criar App"
  4. Selecione o tipo de app:
    • Escolha "Business" ou "Outro"
    • Clique em "Próximo"
  5. Preencha os dados do app:
    • Nome do App: Ex: "Minha Empresa - WhatsApp"
    • Email de contato: Seu email
    • Finalidade do App: Selecione conforme sua necessidade
  6. 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

  1. No painel do seu app, procure por "WhatsApp" na lista de produtos
  2. Clique em "Configurar" no card do WhatsApp
  3. 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):

  1. Na seção "Token de acesso temporário", você verá um token
  2. Este token é válido por 24 horas e serve para testes
  3. Copie este token - você precisará dele mais tarde

Para Produção (60 dias):

  1. No painel do app, vá para "Ferramentas""Explorador de API do Graph"
  2. Selecione seu app
  3. Em "Token de Acesso", clique em "Gerar Token de Acesso"
  4. Selecione as permissões:
    • whatsapp_business_messaging
    • whatsapp_business_management
  5. Este token terá duração de 60 dias

4.2. Phone Number ID

  1. Na seção "Números de telefone", clique no número que você criou
  2. Você verá o "Phone number ID" (um número longo)
  3. 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)

  1. O Meta fornece um número de teste gratuito
  2. Permite enviar mensagens para até 5 números verificados
  3. Ideal para testar a integração sem custos

Para Produção

  1. No WhatsApp Business API, vá para "Números de telefone"
  2. Clique em "Adicionar número de telefone"
  3. Insira o número que deseja usar (deve ser um número que você possui)
  4. Escolha o método de verificação:
    • SMS: Receberá um código por SMS
    • Ligação: Receberá uma ligação com código
  5. Insira o código recebido
  6. 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

  1. No Meta for Developers, vá para WhatsAppGerenciarGerenciar modelos
  2. Clique em "Criar modelo"
  3. 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 EmpresaImportante: multitenant - cada empresa aparece com seu próprio nome
  • {{4}} - Valor Formatado
  • {{5}} - Data de Vencimento
  • {{6}} - URL da Fatura
  • {{7}} - Itens/ServiçosLista formatada de todos os itens ou serviços da fatura
  • {{8}} - ID do DocumentoID/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

  1. Clique em "Enviar para revisão"
  2. Aguarde aprovação (pode levar algumas horas)
  3. 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)

  1. Acesse ConfiguraçõesConfigurações da Plataforma
  2. 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
  3. Ative o toggle "WhatsApp Ativo"
  4. Clique em "Salvar"

Opção B: Configuração por Time (Prioridade sobre a plataforma)

  1. Acesse ConfiguraçõesIntegrações
  2. Clique em "Adicionar Integração" ou "Configurar WhatsApp"
  3. 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
  4. Clique em "Salvar" ou "Testar Conexão"

Ordem de Prioridade

  1. Template configurado na integração do time (se existir)
  2. Template configurado na plataforma padrão (se existir)
  3. Mensagem de texto livre (se nenhum template estiver configurado)

8. Testar a Integração

  1. Após salvar, o sistema tentará validar a conexão
  2. Se tudo estiver correto, você verá uma mensagem de sucesso
  3. 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-4fd6c304f6fc

Template 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

  1. Comece com o modo de teste para validar a integração antes de ir para produção
  2. Use números de teste inicialmente para evitar custos
  3. Monitore os custos no painel do Meta Business
  4. Configure alertas para quando o token estiver próximo de expirar
  5. Mantenha backups dos tokens em local seguro
  6. Use templates para melhor taxa de entrega e confiabilidade

📚 Recursos Adicionais


🆘 Precisa de Ajuda?

Se você encontrou algum problema ou tem dúvidas:

  1. Verifique a seção "Solução de Problemas" acima
  2. Consulte a documentação oficial do Meta
  3. Entre em contato com nosso suporte: suporte@linkpix.co

Última atualização: Janeiro 2025

On this page