Integração ERP Centrium x TextEase
Como integrar o ERP Centrium ao TextEase para disparar mensagens de WhatsApp usando templates.
Objetivo
Descrever como integrar o ERP Centrium ao TextEase, produto da Centrium que dispara mensagens de WhatsApp, para que o sistema envie mensagens aos clientes (cobrança, eventos, aniversariantes, mensagem avulsa etc.) usando templates.
O TextEase dispara pela API do WhatsApp Web ou pela API oficial da Meta. A implantação é sempre a mesma, não importa qual das duas a conta usa.
Requisitos
A integração só funciona se o disparo já estiver acertado. Antes de configurar o ERP, a empresa precisa ter um número ativo no TextEase, em um destes formatos:
| Formato | Quem contrata a conexão | Cobrança das mensagens |
|---|---|---|
| BM do cliente | O próprio cliente | Direto na conta do cliente |
| BM da Centrium | A Centrium | No final do mês, junto com a manutenção do número ativo |
BM é o Business Manager (gerenciador de negócios) da Meta, onde o número de WhatsApp fica registrado.
Também é necessário que a empresa tenha licença ativa de Integração Whatsapp no ERP (ícone do usuário → Licenças).
Visão geral
flowchart LR
A["1. Informar dados do TextEase no ERP"] --> B["2. Associar função ao número de disparo"]
B --> C["3. Associar variáveis dos templates"]
C --> D["4. Salvar função e associações"]
Dados que ligam os dois sistemas, todos obtidos no portal do TextEase e informados no ERP:
| Dado | Observação |
|---|---|
| API-KEY | Vem da conta do cliente no TextEase e vale para todos os números ativos do cliente |
| ID Conta Texteasy AI | Identifica a conta do cliente no TextEase |
| Link Portal Text Easy AI | Endereço de acesso da conta do cliente ao portal |
Portal do TextEase: https://texteaseai.centrium.inf.br/
Passo a passo
1. Configurar o TextEase no ERP
Caminho: ícone do usuário → Configurações → Sistema → Whatsapp-TextEasy (tela WPTextEase_Config).
- Marque Usa Text Ease.
- Marque Usa Modo Templates. A integração precisa usar templates.
- No campo Host, informe
texteaseai.centrium.inf.br. - No bloco TextEaseAI, informe os três dados obtidos no portal do TextEase:
- API-KEY
- ID Conta Texteasy AI
- Link Portal Text Easy AI
- Clique em Confirmar.
O bloco TextEase V1 (Cnt Código, Usuário, Senha, Baixar Contatos e Visualizar Mensagens) não precisa ser configurado.
Atenção: a API-KEY dá acesso à conta do cliente no TextEase. Guarde-a com cuidado e não a compartilhe em e-mails, chats, prints ou documentos.
Os botões do bloco TextEaseAI ajudam na conferência:
- Abrir Portal TextEase AI: abre o portal do TextEase.
- Carregar Contatos: busca no TextEase as funções e as instâncias (números) da conta. Se a API-KEY estiver correta, a lista é carregada.
2. Associar a função ao número de disparo
Ainda na tela de configurações, no bloco Funções:
- Selecione a função (por exemplo, Financeiro Cobrança).
- Informe o id contato, que identifica o número de disparo.
- Marque Contato da função. Assim a configuração vale para todos os usuários.
- Clique em Confirmar.
Cada função representa um tipo de disparo do sistema. A lista de funções e o uso de cada uma estão em Templates do TextEase no CentriumWEB.
3. Configurar os templates
- Na tela
WPTextEase_Config, clique em Configurar Templates. - Na tela
WPTextEase_Templates, selecione o número de telefone. O cabeçalho passa a mostrar a instância selecionada. - Clique em Exibir Templates. A tela lista os templates do número, cada um com seu status: Aprovado ou Rascunho, e Associado ou Não Associado.
- No template que quer configurar, clique no ícone de editar (lápis, coluna Associar).
4. Associar as variáveis do template ao campo do ERP
A tela de edição tem três áreas:
| Área | O que faz |
|---|---|
| Associar variável | Liga cada variável do template a um campo do ERP |
| Prévia da mensagem | Mostra como o template vai chegar ao cliente |
| Finalização | Define a função do template e salva |
Em Associar variável, preencha os três campos:
| Campo | O que é |
|---|---|
| Variável | A variável do template (por exemplo, o nome do cliente) |
| Tipo de cadastro | Filtro dos tipos de campo disponíveis no ERP (por exemplo, Cadastro de Cliente ou Cadastro de Contas a Receber) |
| Atributo | O campo do ERP que será enviado no lugar da variável |
Depois, clique em Adicionar associação. A associação entra na lista Variáveis associadas (colunas Tipo, Variável, Tipo de Cadastro e Descrição). Repita para cada variável do template.
Nem todo tipo de cadastro tem dado disponível em toda função. Se o campo escolhido não existir naquele disparo, a variável chega vazia ao cliente. A tabela de compatibilidade está em Templates do TextEase no CentriumWEB.
5. Salvar a função e as associações
- Na área Finalização, selecione a função no campo Text Ease_Funcoes.
- Clique em Salvar função e associações.
Obrigatório: sem Salvar função e associações, o template não passa a valer.
Repita os passos 3 a 5 para cada template que será usado.
Resultado esperado
- Número ativo no TextEase, com a cobrança definida (BM do cliente ou da Centrium).
- Dados do TextEase informados no ERP.
- Funções associadas aos números de disparo.
- Templates com todas as variáveis associadas e a função salva.
Observações
- Só templates com status Aprovado podem ser enviados pelo WhatsApp.
- Esta versão não inclui teste de disparo na tela. Um teste pode entrar em versões futuras.
- Os pontos do sistema que disparam mensagens e as validações dos templates estão em Templates do TextEase no CentriumWEB.