Moblix

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

  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 Agência - 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 Moblix. 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: 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

  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 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)

  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): booking_confirmation
  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): booking_confirmation
  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 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/abc123xyz

Template 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/abc123xyz

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 Moblix
  • 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@moblix.com.br

Última atualização: Janeiro 2026

On this page