Imagem do card

Integrações com a Message

Manual para Integração por API

A integração com a plataforma MESSAGE permite às empresas clientes utilizarem a rede para transmissão de mensagens e geração de documentos pelos canais de mídias E-mail, SMS e Whatsapp, de forma automática garantindo a gestão completa dos processos de entrega.

Há dois escopos de utilização:

  • TRANSACIONAL: Envios um-a-um (um arquivo gera uma mensagem). Muito utilizado para projetos com mensagens urgentes, com o destinatário aguardando receber a mensagem. Ex.: Acordos de cobrança, Boleto para pagamento, envio de 2º via de fatura mensal, dentre outros. Estes envios trafegam em rede própria e com alta prioridade de envio.
  • CAMPANHAS: Tratamentos para múltiplos destinos gerando envios massivos de transmissão de mensagens, com controles de volumes de envios por hora para os grupos de provedores de webmails.

Para compor um bom planejamento de integração, será preciso responder a estas 3 perguntas:

1- Qual o melhor
método de API?

2- Qual o formato de
arquivo ideal?

3- Qual canal usar?

Desta forma, seguiremos com o detalhamento necessário para responder a estas questões.
Independente do escopo escolhido, poderão ser utilizados todos formatos de APIs disponíveis paralelamente para atender as necessidades de diversos projetos.

IMPORTANTE

Dois passos importantes nas configurações na plataforma de serviços antes de avançar com as integrações:

1º – Cadastrar e validar o(s) e-mail(s) de Remetente(s)
2º – Criar uma Chave de API (API KEY)

Há as seguintes opções:

MÉTODO/ PROTOCOLO TROCA DE ARQUIVOS HOSPEDAGEM DE TEMPLATE
API POST CSV, TXT, XML ou PDF# (ZIP) Requisições em JSON Opcional
API GET N/A - Variáveis na URL Sim
SMTP N/A - Restrições no tamanho e extensão de anexos Não
SFTP CSV, TXT, XML ou PDF# (ZIP) Sim

MÉTODOS DE INTEGRAÇÃO

Após a geração do arquivo de mailing, é necessário planejar a entrega deste arquivo para a MESSAGE . Todas as APIs estão baseadas em conexões orientadas com segurança TLS 1.2 e SSL, e monitoradas com diversas regras de segurança.

API POST

API para o envio de informações e arquivos utilizando HTTPS com as seguintes possibilidades:
.

  • Enviar e-mail ou SMS
  • Enviar e-mail ou SMS usando Template
  • Enviar mailing de campanhas
  • Relatório de monitoramento
  • Relatório status de entrega/leitura/cliques
  • Relatório de interações

API GET

API para o envio de dados utilizando HTTPS. A URL poderá conter os campos de dados com as variáveis
necessárias para compor uma mensagem em diversos canais.

Exemplo:

https://post.messagecenter.com.br/integracao/envioget.ashx?envio_formato=sms&envio_modelo=Boas_vindas&envio_para=11999998888&envio_mensagem=Precisamos falar com voce

Customizações:
Incluir diversas variáveis aos modelos de corpo de e-mail, SMS, whatsapp e ainda solicitar relatórios ao sistema.

SMTP

Esta integração é de baixa complexidade pois se utiliza de padrões já bem difundidos e não envolvem alinhamentos sobre hospedagem de templates.
URL: smtp.messagecenter.com.br

Também é possível utilizar os envios de SMS endereçando a mensagem SMTP desta forma:

to: 11999998888@sms.
messagecenter.com.br
subject: TEXTO DA MENSAGEM
(Até 160 caracteres, sem caracteres especiais e sem variáveis)

Limites:

  • Limite de 1MB por cada o anexo em cada mensagem;
  • Limite de 100 destinatários para cada mensagem enviada;
  • Limite de 10 conexões simultâneas;
  • CC e CCO são tarifados como e-mails avulsos

SFTP

Ambiente de pastas para troca de arquivos de dados, ideal para projetos com alto volume.

O processo de integração por SFTP se trata do cliente disponibilizar acesso à(s) pasta(s) interna(s) onde a MESSAGE irá configurar processos para “retirar” os arquivos varrendo estas pastas de 20 em 20 segundos.

Já sabe qual o melhor método de API?

HOSPEDAGEM DE TEMPLATES

Alguns métodos de envios precisam ter suas configurações de modelos previamente alinhadas no site de serviços da MESSAGE. Estas configurações poderão conter informações fixas cadastradas que facilitarão o uso das APIs, são elas:

Nome e Remetente de e-mail

Corpo de e-mail (HTML)

Template de texto de mensagens de SMS

Template de arquivo para PDF

Incluir senha de acesso no PDF

IMPORTANTE: Nossa equipe de Atendimento está pronta para ajudá-los nas escolhas de métodos de APIs e nas configurações necessárias.

Em todas as APIs há diversas opções de canais. Em cada canal escolhido haverão configurações previas a serem acordadas para estarem disponíveis.

TRATAMENTO DE ARQUIVOS

A plataforma possui desenvolvidos “endpoints” para o processamento dos seguintes formatos de arquivos:

Extensible Markup Language (XML) é uma linguagem desenvolvida para a descrição de dados (conteúdo). O Código “CDATA” auxilia no tratamento de arquivos em formato XML para o envio de caracteres especiais não aceitos normalmente para a validação XML.

 Segue exemplo: <![CDATA[VALOR]]>

Desta forma poderá utiliza-lo assim:

<envio_contato><![CDATA[C & A]]></envio_contato>

O layout proposto para o XML está voltado a projetos para a geração de boletos e mensagens SMS contendo dados para pagamento.
O detalhamento do layout de um arquivo XML poderá ser feito pelo envio de um arquivo modelo por nossa equipe de Atendimento.

A estruturação de dados em arquivos de formato TXT permite sua localização por parâmetros linha x coluna, com a composição de blocos de dados que poderão conter informação para a geração de comunicações de diversos escopos.

Um dos formatos utilizados é o CNAB400 para a troca de informações de pagamentos via boletos e geração e proposta de acordos.

Arquivos de dados utilizando separadores como “;” são os mais comuns nos envios de campanhas, onde podemos estruturar as capturas de dados linha a linha.
Podemos planejar a nomeação dos dados da seguinte forma:

  • Sequencial: de acordo com a localização sequencial dos dados: 1º dado; 2º dado; 3º dado; etc…
    fulano@gmail.com; FULANO ; 10/02/2022 : 123456 
    ciclano@hotmail.com : CICLANO ; 11/02/2022 : 654321
    11999998888; BELTRANO; 12/02/2022 : 789123
  • Cabeçalho: Nomear os dados enviados pelo cabeçalho na primeira linha do arquivo,
    EMAIL ou CELULAR; NOME; DATA COMPRA; CONTRATO
    fulano@gmail.com; FULANO ; 10/02/2022 : 123456
    ciclano@hotmail.com : CICLANO ; 11/02/2022 : 654321
    11999998888; BELTRANO; 12/02/2022 : 789123

Neste formato precisamos que as informações variáveis sejam enviadas no nome do arquivo, usando como separador de dados “#”, conforme exemplos a seguir:

  • Exemplo para e-mail:
    BOAS_VINDAS#fulano@gmail.com#Fulano Silva#12345678910.pdf
  • Exemplo para SMS:
    ACORDO#1199998888#Fulano Silva#12345678910.pdf

Mapeamento dos dados:

MODELO # DESTINATARIO # NOME CLIENTE # DOCUMENTO CLIENTE.pdf

Este mapeamento é feito de acordo com o modelo, assim poderá haver diversos modelos mapeados no sistema para atender às necessidades de diversos projetos.
Não há limites que quantidades de variáveis. Os únicos campos obrigatórios são o código do modelo, que deve ser informado sempre na primeira posição, e o destinatário de envio (e-mail ou celular). Todas as variáveis enviadas poderão compor os textos personalizados no corpo de e-mail, mensagens de SMS ou ainda compor os dados de relatórios de status.

Já sabe qual o melhor método de API?

CANAIS DE ENVIO

Cada CANAL tem suas configurações necessárias e que precisarão ser contratadas e definidas com as equipes de Atendimento.

 

Estão disponíveis as seguintes opções de canais de transmissão:

CANAL STATUS INTERAÇÃO
E-mail Entrega, lido, clicou Trata Resposta
E-mail com anexo Entrega, lido, clicou Trata Resposta
SMS Entrega, respondeu Chatbot SMS
SMS com link PDF Entrega, respondeu, clicou Chatbot SMS
E-mail/SMS com link CHAT Entrega, respondeu, clicou Chatbot WEB
Whatsapp Entrega, PDF enviado Chatbot
Geração de PDF Gerado, download Site enviodeboleto.com.br

E-mail e E-mail com anexo

Nosso grande diferencial é a entregabilidade dos e-mails!

Com robusta redes de transmissores de e-mail com monitoramento sistêmico de reputação junto aos grandes provedores globais de webmails e diversos recursos de analise tornam ESPECIAIS as entregas

Precisa esquentar o IP? Aqui na Message quem faz esta gestão são nossos sistemas. São gerenciados os volumes/horas por domínios garantindo uma boa entregabilidade das mensagens.

SMS e SMS com link

São utilizadas conexões de alta qualidade com todas as operadoras nacionais para a entrega das mensagens de SMS

Podem ser utilizados os domínios curtos para as comunicações:

  • Códigos para pagamentos
  • Faturas mensais e boletos
  • Tokens de acesso e aprovações
  • Pesquisas e avaliações
  • Avisos urgentes ou promocionais

URLs utilizadas:

boleto.digital para acesso à arquivos PDF ou inclusão de lembretes e eventos (invites) na agenda do celular

atende.digital para acesso chatbot ou encurtador de URL para monitorar cliques

WhatsApp®

Integrado com a API oficial Whatsapp® com a Meta que permite interação de forma escalável das conversas ao aplicativo.

Processo de demonstração de interação:

INTERAJA COM O BOT

CHATBOT por E-mail/SMS

A solução de CHATBOT integra os canais de comunicação por e-mail e SMS através de fluxos de conversas automáticas para:

  • Pesquisas de satisfação
  • Confirmações rápidas
  • Solicitação de documentos ou comprovantes,
  • Proposta de acordo, dentre inúmeras funcionalidades

Há componentes que integram as informações da conversa com os sistemas externos:

  • Message API: Componentes que integram a conversa com os sistemas legados. Exemplo: Negociação de dívidas
  • Pagamento: Integração com meios de pagamento onde a conversa segue a ambiente seguro com os dados de cadastro e compra pré definidos.
EXPERIMENTE O CHATBOT WEB

Geração de PDF

Tratamento de arquivos de dados estruturados gerando lotes de arquivos em formato PDF que ficarão hospedados e poderão ser acessados por:

Short links: URL curtas de acesso*
Exemplo https://boleto.digital/12345678
*lote de URLs em arquivo formato CSV

Website de apoio: Será personalizado nas cores e textos auxiliando seus projetos na entrega de documentos, boletos e fatura

Exemplo de Site:
demonstracao.enviodeboleto.com.br

Já sabe qual canal usar?

ENTRE EM CONTATO

    ENVIAR

    Fale com

    a gente agora!