Wiki - Centrium Sistemas

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

  1. Marque Usa Text Ease.
  2. Marque Usa Modo Templates. A integração precisa usar templates.
  3. No campo Host, informe texteaseai.centrium.inf.br.
  4. No bloco TextEaseAI, informe os três dados obtidos no portal do TextEase:
    • API-KEY
    • ID Conta Texteasy AI
    • Link Portal Text Easy AI
  5. 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:

2. Associar a função ao número de disparo

Ainda na tela de configurações, no bloco Funções:

  1. Selecione a função (por exemplo, Financeiro Cobrança).
  2. Informe o id contato, que identifica o número de disparo.
  3. Marque Contato da função. Assim a configuração vale para todos os usuários.
  4. 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

  1. Na tela WPTextEase_Config, clique em Configurar Templates.
  2. Na tela WPTextEase_Templates, selecione o número de telefone. O cabeçalho passa a mostrar a instância selecionada.
  3. 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.
  4. 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

  1. Na área Finalização, selecione a função no campo Text Ease_Funcoes.
  2. 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

Observações