Configuração do WhatsApp
Guia completo passo a passo para configurar o WhatsApp Business API e enviar mensagens automáticas de reservas e orçamentos de viagem
Configuração do WhatsApp Business API
Configure o WhatsApp Business API através do Meta (Facebook) para enviar mensagens automáticas quando suas reservas e orçamentos de viagem forem enviados aos clientes.
Por que usar WhatsApp?
O WhatsApp é o canal de comunicação preferido dos brasileiros. Enviar confirmações de reservas e orçamentos pelo WhatsApp aumenta significativamente as taxas de visualização e conversão.
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 Moblix
- 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 Agência - 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 Moblix. 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:
booking_confirmation(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 confirmações de reserva:
Olá {{1}}!
✈️ Reserva {{2}} - {{3}}
📋 Detalhes:
{{7}}
💰 Valor Total: {{4}}
📅 Data da Viagem: {{5}}
🔗 Acesse aqui: {{6}}Variáveis do Template:
{{1}}- Nome do Cliente{{2}}- Número da Reserva{{3}}- Nome da Empresa - cada agência aparece com seu próprio nome{{4}}- Valor Formatado{{5}}- Data da Viagem{{6}}- URL da Reserva{{7}}- Detalhes da Viagem - voos, hotéis, experiências incluídos{{8}}- ID do Documento - ID/token do documento (para botões do WhatsApp)
Dica Multitenant
A variável {{3}} permite que o mesmo template funcione para todas as agências do sistema, mas cada uma aparece com sua própria identidade nas mensagens.
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 Moblix usando mensagens de texto livre.
7. Configurar no Moblix
Agora vamos conectar tudo no Moblix:
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):
booking_confirmation
- 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):
booking_confirmation
- 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 reserva 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 Reservas
Nome do Template: booking_confirmation
Corpo da Mensagem:
Olá {{1}}!
✈️ Reserva {{2}} - {{3}}
📋 Detalhes:
{{7}}
💰 Valor Total: {{4}}
📅 Data da Viagem: {{5}}
🔗 Acesse aqui: {{6}}Exemplo de Mensagem Enviada:
Olá João Silva!
✈️ Reserva MBX-2026-00042 - Viagens Premium LTDA
📋 Detalhes:
• Voo GRU → GIG (GOL G3 1234) - 15/03 08:00
• Voo GIG → GRU (GOL G3 1235) - 20/03 18:00
• Hotel Copacabana Palace - 5 diárias
💰 Valor Total: R$ 5.750,00
📅 Data da Viagem: 15 a 20 de março de 2026
🔗 Acesse aqui: https://app.moblix.co/b/abc123xyzTemplate para Orçamentos de Viagem
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-2026-00015 - Viagens Premium LTDA
📋 Itens:
• Voo GRU → GIG (ida e volta) - R$ 1.250,00
• Copacabana Palace (5 diárias) - R$ 4.500,00
• Passeio de Helicóptero (2 pessoas) - R$ 1.780,00
• Transfer aeroporto/hotel - R$ 300,00
💰 Valor Total: R$ 7.830,00
📅 Válido até: 15 de fevereiro de 2026
🔗 Acesse aqui: https://app.moblix.co/q/abc123xyzCustos 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 Moblix
- 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@moblix.com.br
Última atualização: Janeiro 2026