Sumário

Referência de mensagens

Antes de darmos mais detalhes sobre as referências de mensagens precisamos lhe introduzir o problema que desejamos sanar. Logo após lhe explicaremos o que é a referência em si e como ela funciona.

Por que existe a referência?

Como sabemos o WhatsApp nos permite trabalhar com texto / mensagens de uma forma muito elabora, de forma muito superior que os SMS. Porém, o WhatsApp é relativamente novo, quando comparado ao lançamento dos ERPs para provedores de internet, naquela época só existia o SMS, sendo assim os desenvolvedores dos ERPs prepararam seus sistemas para trabalhar com o SMS e suas limitações.

Algumas das limitações dos SMS naquela época eram:

Mensagens com no máximo 160 caracteres;
Não aceitava caracteres especiais;
Não contia estilizações ( negrito, itálico etc ).

Então em suma a maioria dos ERPs para provedores foi projetado e pensado com essas limitações e nem todos se adequaram ainda as novas tecnologias, como nosso sistema nasceu para conectar seu ERP ao WhatsApp essas limitações trazidas devido às integrações serem pensadas para SMS nos atrapalharia e muito, pois não conseguiríamos explorar todo o poder das funcionalidades WhatsApp, sendo:

Mensagens com textos de até 65 mil caracteres;
Envio de arquivos ( Boletos, PDF etc );
Envio de imagens;
Uso de caracteres especiais nas mensagens;
Utilização de emojis;
Mensagens contendo links clicáveis;
Estilizações de texto como negrito, itálico, tachado e monoespaçado.

Então precisávamos de uma forma de integrar perfeitamente com os ERPs e usar todo o poder do WhatsApp, nascendo a referência de uma mensagem.

O que é uma referência?

Diante do problema informando anteriormente procuramos uma solução para receber os dados do seu ERP de uma forma eficiente, fácil de dar manutenção e principalmente compatível com as limitações de alguns ERPs. Com isso optamos por utilizar a formatação de dados JSONopen in new window, a qual é amplamente adotada no mundo da tecnologia, sendo o padrão usado por basicamente toda internet.

Então com o uso da referência o seu ERP pode identificar qual mensagem ele deseja enviar e, além disso, ele conseguirá passar os dados dinâmicos dos seus clientes, sendo possível usar os nomes, dados de cobrança etc de cada cliente seu dentro do texto das mensagens.

Como usar?

O uso da referência é muito simples, aqui está um passo a passo:

Acesse a página de Mensagens clicando aquiopen in new window
Caso tenha mensagens cadastradas:
1. Você verá uma lista de mensagens;
2. Na listagem terá uma coluna chamada "Referência"
3. Escolha uma mensagem e clique no botão de copiar;
4. Pule para o passo 4 deste passo a passo.
Caso não tenha cadastrado nenhuma mensagem:
1. Clique no botão "+ Adicionar";
2. Crie sua mensagem;
3. Clique em salvar;
4. Abrirá um modal com a referência da mensagem recém criada;
5. Clique no botão de copiar.
Acesse seu ERP;
Vá até à mensagem que você deseja configurar;
No campo de texto remova todo o conteúdo;
No mesmo campo de texto, cole a referência que você copiou no passo 2.3 ou 3.5 deste passo a passo;
Clique em salvar.

Pronto, agora seu ERP já estará utilizando a mensagem criada, estilizada e configurada dentro do nosso painel, explorando todas as funcionalidades que o WhatsApp fornece.

Uma referência real

Atenção

As referências a seguir não devem ser usadas, pois são exemplos, não estão configuradas dentro do nosso sistema a utilização das mesmas resultará na perda dos disparos, pois nosso sistema valida todos os dados de cada solicitação de envio recebida, inclusive se a referência existe em sua conta.

O mesmo vale para mensagem base a seguir, as variáveis contidas nela não existem para determinados ERPs.

Como base para gerar uma referência utilizamos esse texto de mensagem:

Olá $cliente_nome_completo$, como vai?

Sua fatura com vencimento no dia $cobranca_vencimento$ e no valor de R$ $cobranca_valor$ está pronta para pagamento.

Assim ficará mais fácil para você compreender como a referência é gerada e como os dados são fornecidos ao nosso sistema.

MK Solutions

{
  "1":"012",
  "y":"#cliente#",
  "E":"#valor#",
  "D":"#vencimento#"
}

IXC

No caso do IXC em determinadas mensagens ele adiciona dados extras, como mensagens do sistema etc, esse mesmo conteúdo além de ser indesejado por alguns clientes, ele também faz com que o nosso sistema não reconheça o JSONopen in new window, por tanto, criamos uma abstração onde os delimitadores #REMOVE e REMOVE# indicam que tudo que vem antes ou após o determinado delimitador deve ser removido pela camada de abstração e após isso ser enviado para a rotina de envio.

#REMOVE
{
  "1":"012",
  "r":"#cliente_nome#",
  "E":"#areceber_valor#",
  "D":"#areceber_data_vencimento#"
}
REMOVE#

SGP

{
  "1":"012",
  "y":"{cliente}",
  "E":"{valor}",
  "D":"{vencimento}"
}

MK Auth

{
  "1":"012",
  "y":"%nomecliente%",
  "E":"%valortitulo%",
  "D":"%vencimento%"
}

Vigo

O sistema Vigo não possuí variáveis, por tanto, nosso sistema não recebe dados dinâmicos do mesmo através da referência.

{
  "1":"012"
}

Controllr

{
  "1":"012",
  "y":"{CLI_NAME_FULL}",
  "E":"{COB_VAL_DOC}",
  "D":"{COB_DATE_VENC}"
}

Router BOX

O Router BOX não possuí uma variável para o valor da fatura.

{
  1:012,
  r:|NOME|,
  S:|DIA_VENC|
}

Note a seguinte estrutura:

Linha 2: iniciada com "1", a mesma é a identificação da mensagem dentro do nosso sistema;
Linha 3: iniciada com "y", responsável por informar o nome do cliente ao nosso sistema;
Linha 4: iniciada com "E", responsável por informar o valor da fatura;
Linha 5: iniciada com "D", responsável por informar a data de vencimento;
Linhas 1 e 6: são os delimitadores de um JSONopen in new window.

Desta forma foi possível usufruir de todo o potencial do WhatsApp junto aos ERPs, utilizando dos dados dinâmicos de cada cliente seu.

Atenção no uso da referência

Variáveis não substituídas

Caso o seu ERP não substitua uma das variáveis nosso sistema irá barrar o envio da determinada mensagem para que a mesma não vá desta forma para seu cliente:

Olá #cliente_nome#, como vai?

Sua fatura com vencimento no dia 10/10/2010 e no valor de R$ 59,90 está pronta para pagamento.

Note que onde era para ter o nome do seu cliente está preenchido com #cliente_nome#, isso ocorreria se o seu ERP não fizesse a substituição da variável #cliente_nome# e nosso sistema enviasse mesmo assim.

Variáveis substituídas por valor em branco

Uma referência completamente preenchida é enviada assim para o nosso sistema:

{"1":"012","r":"João Maria","E":"59,90","D":"10\/10\/2010"}

Mas em alguns casos e em alguns ERPs a variável pode ser simplesmente removida e não ter um valor atribuído para ela ficando assim:

{"1":"012","r":"","E":"59,90","D":"10\/10\/2010"}

Diante disto nosso sistema irá enviar a mensagem da seguinte forma:

Olá , como vai?

Sua fatura com vencimento no dia 10/10/2010 e no valor de R$ 59,90 está pronta para pagamento.

Como você pode notar ele irá enviar a mensagem mesmo com uma informação em branco, já que o ERP substituir a variável em branco pode ser uma ação desejada.

Conclusão

A referência é uma funcionalidade extremamente útil e necessária para uma boa comunicação com seus clientes, com ela você poderá criar mensagens adequadas para o dia a dia e de fácil compreensão.

Uma referência é baseada em JSONopen in new window, usado para formatar os dados e não haver perda de nenhuma informação.

# Sumário

# Referência de mensagens

# Por que existe a referência?

# O que é uma referência?

# Como usar?

# Uma referência real

# Atenção no uso da referência

# Variáveis não substituídas

# Variáveis substituídas por valor em branco

# Conclusão