Suporte ao Sistema de Envio - API WhatsApp (Meta)

Tela de Login
🔐 Acessar Painel ATIVANET

📌 Instruções Iniciais

Para utilizar o sistema de envio de mensagens via API oficial do WhatsApp (Meta), acesse o painel com seu login e senha. Após o login, siga as instruções para conectar seu número, obter seu token e configurar os envios.

📊 Visão Geral do Sistema

Dashboard ATIVANET

Na tela inicial do sistema (Dashboard), você encontra os seguintes indicadores:

  • Conexões: Número de números conectados ao sistema (neste exemplo: 1).
  • Contatos: Total de contatos cadastrados para envio de mensagens (neste exemplo: 83).
  • Grupos: Número de grupos ativos para campanhas em massa (neste exemplo: 8).
  • Mensagens: Total de mensagens já enviadas (neste exemplo: 3.784).

🔗 Gerenciamento de Conexões

Tela de Conexões

No menu lateral, clique em WhatsApp > Conexões para visualizar os números já conectados ao sistema.

  • Você verá a lista de números, o status da conexão (ícone de Wi-Fi verde indica ativo), e o campo de notificações.
  • Evite remover ou alterar conexões ativas sem necessidade.
Adicionar nova conexão

Para adicionar uma nova conta da API oficial do WhatsApp:

  1. Clique no botão de adicionar nova conexão (ícone + no canto superior direito).
  2. Preencha os seguintes campos:
    • WhatsApp: Número no formato internacional (ex: 559292098675).
    • MetaID: ID fornecido no Business Manager da Meta.
    • WabaID: ID do ambiente de API do WhatsApp Business.
    • Bearer: Token de autenticação da Meta.
    • Version: Versão da API (ex: v19.0).
  3. Clique em Salvar para finalizar.

⚠ Atenção: Só edite ou exclua uma conexão se tiver certeza do impacto. A exclusão incorreta pode interromper os envios automáticos.

🔌 Integração com IXCSoft

Integração Sucesso IXCSoft

O sistema permite integração direta com o IXCSoft, possibilitando envio de notificações automatizadas via WhatsApp com base nos dados do provedor.

Se a integração estiver corretamente configurada, será exibida a mensagem "Sucesso!".

Configuração de integração IXCSoft

Para configurar corretamente a integração:

  • Selecione a Conexão correspondente ao número que será usado nos envios.
  • Em ISP, selecione IXC.
  • Preencha a URL com o endereço da API do seu sistema IXC (exemplo: https://ixc.ativanetms.com.br).
  • Informe o Token de acesso gerado dentro do seu painel do IXC.
  • Insira o CPF ou CNPJ para validação de teste.
  • Finalize clicando em Salvar.

⚠ Atenção: Somente altere esses dados se houver mudança no IXC (como troca de URL ou token). Erros aqui podem interromper os envios.

📢 Envio de Campanhas e Avisos

Campanha - Passo 1

Para enviar mensagens em massa ou notificações como lembretes, acesse o menu Marketing > Campanhas e siga os 3 passos:

1️⃣ Passo 1 – Nome e Template

  • Digite o nome da campanha (ex: Aviso de Vencimento Maio).
  • Escolha um dos templates aprovados pela Meta.
Campanha - Passo 2

2️⃣ Passo 2 – Grupo e Data

  • Selecione o grupo de contatos ao qual a campanha será enviada.
  • Escolha a conexão (número do WhatsApp) que fará os envios.
  • Informe a data e hora de início.

Dica: para enviar mensagens imediatas, selecione uma data anterior à data atual. Assim, o sistema interpretará como "enviar agora".

Campanha - Passo 3 e envio

3️⃣ Passo 3 – Confirmação

Revise os dados:

  • Template com variáveis substituídas (ex: nome e vencimento).
  • Contatos que irão receber a mensagem.
  • Conexão correta e ativa.

Finalize clicando em Submit.

👥 Grupos e Importação de Contatos

Lista de Grupos de Contatos

No menu Marketing > Grupos você pode criar e gerenciar grupos de contatos para organizar seus envios.

  • Cada grupo pode conter uma lista separada de números para campanhas específicas.
  • No menu de ações (três pontinhos), é possível editar, importar CSV ou excluir.
Importar Contatos CSV

Para importar seus contatos:

  1. Clique em Importar CSV.
  2. Use o botão Baixar Modelo de Importação para seguir o padrão correto.
  3. Preencha a planilha com:
    • Nome
    • Telefone com DDD (Ex: 22988713139)
    • (opcional) E-mail, CPF/CNPJ e Data de nascimento
  4. Faça o upload do arquivo e clique em Salvar.
Contatos do Grupo

Após importar, clique sobre o grupo e veja os contatos cadastrados. Você pode:

  • Visualizar todos os dados (nome, telefone, e-mail, CPF/CNPJ, nascimento)
  • Editar ou excluir contatos individualmente

Dica: Sempre revise os dados antes de iniciar uma campanha para evitar falhas no envio.

📄 Templates de Mensagem

Templates Aprovados

Todos os envios pelo WhatsApp oficial via API da Meta devem utilizar templates aprovados. Esses templates:

  • Devem ser criados dentro da conta Meta Business associada ao número de envio.
  • Só aparecerão no sistema se estiverem com status APPROVED.
  • Devem ser do tipo Marketing para campanhas e notificações.

No sistema, você verá os templates organizados com suas variáveis (ex: {{1}}, {{2}}) que serão preenchidas automaticamente com os dados do grupo.

Atenção: se um template estiver com status diferente de APPROVED, ele não será enviado. Sempre revise antes de usar.

🔗 Integração com IXC para Notificações

Configuração de Integração com IXC

Para configurar o envio automático de mensagens via IXC, preencha os campos conforme a imagem acima:

  • Gateway: Selecione Gammu.
  • Usuário / Senha: Utilize o Token Account fornecido pelo suporte.
  • URL: https://ativanetms.blog.br/notifica/ixc/
  • Shortcode: Recomendado marcar como Sim para personalização de mensagens.

Atenção: Não altere esses dados a menos que tenha recebido instruções do suporte técnico. Uma configuração incorreta pode afetar os envios automáticos via CRM.

📌 Se precisar de ajuda, clique no botão de suporte ao final desta página.

🖼Logs de envios

Imagem 1 Imagem 2 Imagem 3

📊 Verificação e Análise de Logs de Envio

Os logs são fundamentais para acompanhar o status de envio de mensagens via API do WhatsApp e integração com o IXC.

✅ Passos para verificação correta:

🔴 Erros comuns

🟢 Confirmação de Sucesso

Dica: Utilize sempre campanhas teste antes de envios em massa. Revise as variáveis, grupo de contatos e template para evitar falhas.

✍️ Criação de Mensagens Modelo no IXC

Para que a mensagem seja enviada corretamente via API e reconhecida pela plataforma Meta, siga rigorosamente as regras de formatação no IXCSoft.

📌 Formatos válidos:

📨 Exemplo com 2 variáveis:

avisos_vencimento_nome_data|Edna Aparecida do Carmo|05/05/2025

📩 Resultado no WhatsApp:

Olá, Edna Aparecida do Carmo! 👋

📅 Próximo vencimento:
05/05/2025

🔗 Acesse nossa Central do Assinante:
https://www.ativanetms.com.br/central_assinante_web/login

📋 Importante:

📌 Exemplo de inserção no IXC:

avisos__antecipado|#cliente_razao#|#areceber_data_vencimento#|#link_gateway#

Atenção: A ausência ou erro em qualquer uma das variáveis causará falha no envio da mensagem.

🎥 Vídeos de Treinamento – Plataforma de Envios

Para garantir o uso correto da plataforma, recomendamos fortemente que os seguintes vídeos sejam assistidos na ordem. Eles oferecem uma visão prática completa sobre criação de templates, integrações e envio de campanhas.

📌 Vídeo 1 – Treinamento Geral com Explicações Práticas

Resumo: Sessão completa com demonstrações ao vivo sobre criação de templates na Meta, configuração de integrações, funcionamento do IXC e envios práticos.

📌 Vídeo 2 – Visão Geral da Plataforma

Resumo: Apresentação funcional da plataforma, incluindo menus, templates, campanhas e uso das ferramentas de marketing.

📌 Vídeo 3 – Integração IXC com Plataforma de Envios

Resumo: Mostra passo a passo como conectar o sistema IXC ao módulo de envio de mensagens via WhatsApp, além de testes e logs.

📌 Recomendação: Assista aos vídeos antes de realizar qualquer configuração no sistema. Isso evitará falhas e garantirá total domínio das etapas.