Pular para o conteúdo principal

Provedores de Mensagens

Configurações → Comunicações → Provedores de Mensagens é onde você conecta o LeadHub a canais de mensagens bidirecionais. Uma vez configurados, os leads podem ser contatados diretamente a partir da visualização detalhada deles, e as mensagens de entrada desses canais chegam em Conversas.

Canais suportados:

CanalDireçãoProvedor
WhatsAppEnvio e RecebimentoMeta Cloud API (WhatsApp Business)
SMSEnvio e RecebimentoTwilio Programmable Messaging
TelegramEnvio e RecebimentoTelegram Bot API
ViberEnvio e RecebimentoViber Business Messages
Voz (Click-to-Call)Saída + GravaçãoTwilio Programmable Voice

WhatsApp Business (Meta Cloud API)​

Pré-requisitos​

  • Uma Conta Meta Business em business.facebook.com
  • Uma Conta WhatsApp Business com número de telefone aprovado
  • O número deve estar registrado na WhatsApp Cloud API (não no aplicativo WhatsApp comum)

Passo 1 — Crie um App Meta​

  1. Vá para developers.facebook.com → Meus Apps → Criar App.
  2. Selecione Business como tipo de app.
  3. Dê um nome (ex.: LeadHub Integration) e clique em Criar App.
  4. Em Adicionar Produtos, encontre WhatsApp e clique em Configurar.

Passo 2 — Obtenha Suas Credenciais​

  1. No painel do produto WhatsApp, vá para Configuração da API.
  2. Anote:
    • ID do Número de Telefone (numérico, ex.: 106540352242922)
    • ID da Conta WhatsApp Business
  3. Vá para Usuários do Sistema (nas Configurações de Negócios) → crie um usuário do sistema → gere um Token de Acesso Permanente com permissão whatsapp_business_messaging.

Passo 3 — Configure no LeadHub​

  1. Vá para Configurações → Comunicações → Provedores de Mensagens.

  2. Expanda a seção WhatsApp Business e preencha:

    CampoValor
    HabilitadoAtivar
    Token de Acesso PermanenteDo Passo 2
    ID do Número de TelefoneDo Passo 2
    Número de Telefone ExibidoSeu número WhatsApp (ex.: +55-11-99999-9999)

  3. Clique em Salvar Configurações.

  4. A URL do Webhook de Entrada aparece após salvar.

Passo 4 — Registre o Webhook na Meta​

  1. No painel do App Meta, vá para WhatsApp → Configuração → Webhooks.
  2. Defina a URL de Callback para sua URL do Webhook de Entrada do Passo 3.
  3. Defina o Token de Verificação para qualquer string (ex.: leadhub_verify).
  4. Assine o campo de webhook messages.

Teste: Envie uma mensagem para seu número WhatsApp pelo celular. Ela deve aparecer como uma nova Conversa no LeadHub.

SMS (Twilio Programmable Messaging)​

Passo 1 — Obtenha Credenciais Twilio​

  1. Faça login em console.twilio.com.
  2. No Painel, copie seu Account SID e Auth Token.
  3. Em Números de Telefone → Gerenciar → Números ativos, anote seu número Twilio.

Passo 2 — Configure no LeadHub​

  1. Vá para Configurações → Comunicações → Provedores de Mensagens.

  2. Expanda SMS (Twilio) e preencha:

    CampoValor
    HabilitadoAtivar
    Account SIDAC... do painel Twilio
    Auth TokenDo painel Twilio
    Número do RemetenteSeu número Twilio no formato E.164 (ex.: +5511999999999)

  3. Clique em Salvar Configurações e copie a URL do Webhook de Entrada.

Passo 3 — Registre o Webhook no Twilio​

  1. No Twilio, vá para Números de Telefone → Gerenciar → Números ativos → clique no seu número.
  2. Em Mensagens → Uma mensagem chega, defina a URL do webhook.
  3. Defina o método como HTTP POST e salve.

Telegram​

Passo 1 — Crie um Bot Telegram​

  1. Abra o Telegram e envie uma mensagem para @BotFather.
  2. Envie /newbot e siga as instruções (nome e nome de usuário).
  3. O BotFather fornece um Token do Bot (formato: 123456:ABCdef...).

Passo 2 — Configure no LeadHub​

  1. Expanda Telegram em Provedores de Mensagens e preencha o Token do Bot e Nome de Usuário do Bot.
  2. Clique em Salvar Configurações.

O LeadHub registra automaticamente o webhook no Telegram — você não precisa colar a URL manualmente.

Viber Business Messages​

⚠️ O Viber Business Messages requer uma conta de serviço Viber aprovada (conta ISV/business). Contas pessoais Viber não podem enviar mensagens comerciais.

Configure da mesma forma: obtenha seu Auth Token no Portal de Parceiros Viber, preencha no LeadHub e registre a URL do Webhook de Entrada no painel da sua conta de serviço.

Voz / Click-to-Call (Twilio Voice)​

Pré-requisito: SMS (Twilio) deve estar configurado primeiro — Voz reutiliza o mesmo Account SID e Auth Token.

  1. Expanda Voz (Twilio Voice) e configure: número de voz, gravação de chamadas e transcrição automática.
  2. Salve — três URLs aparecem: TwiML URL, Status URL e Recording URL.
  3. Registre essas URLs nas configurações de voz do número no painel Twilio.

Solução de Problemas​

ProblemaSolução
"Salve as configurações para gerar a URL do webhook de entrada"Preencha as credenciais e clique em Salvar primeiro
Verificação do webhook WhatsApp falhaCertifique-se de que o Token de Verificação na Meta corresponde ao configurado
Mensagens do Telegram não chegandoVerifique se o Token do Bot está correto
Teste de SMS falhaConfirme se o Auth Token está correto e seu número Twilio está ativo
Tokens aparecem mascarados (••••••••••••)Isso é intencional — os segredos existentes são mascarados por segurança. Deixe sem alterar para manter o segredo armazenado.