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