Fluxo de mensagem e API

Fluxo de Mensagem

Fluxo simplificado: MT, Callback, DLR, MO

API HTTPS

Esta API permite que você automatize as requisições de envios de mensagens, únicas ou em lote, e a recuperação dos status de envio através de consultas. Ela utiliza o protocolo HTTP com TLS e aceita os métodos GET, com a passagem de parâmetros na query string, ou POST, com parâmetros em JSON.

Autenticação

Para efetuar envios e consultas em nossa API é necessária a autenticação por meio de usuário ou e-mail, em conjunto com um token.

Campo	Detalhes	Data Type
UserName	Seu usuário ou email	String
Authentication Token	Seu token de autenticação. Adquira o seu aqui (mesmo link).	String
TemplateID	Identificador de modelo de SMS. O texto da mensagem será recuperado e deve ser criado primeiro por meio do Portal do Messaging.	Long
TemplateName	Nome do modelo de SMS. Pode não ser exclusivo, resultando em erro se mais de um modelo for encontrado para o nível de acesso do usuário. O texto da mensagem será recuperado e deve ser criado primeiro por meio do Portal do Messaging.	String

Detalhes de conexão

Campo	Detalhes
Hostname	api-messaging.wavy.global
API's	Envios individuais /v1/send-sms Envios em lote /v1/send-bulk-sms
Porta	443 (https)
Protocolo	HTTPS (encriptação TLS)
Autenticação	username + token
Portal	messaging.wavy.global

Para enviar mensagens e obter status por meio da API, é necessário autenticar usando uma combinação de nome de usuário ou e-mail e token de autenticação. Os parâmetros abaixo deverão estar presentes em cabeçalhos específicos da sua solicitação

Codificação (encoding)

O Padrão de codificação utilizado é o UTF-8, todo conteúdo das mensagens deve seguir esse padrão.

É possível escapar os caracteres caso deseje ou codificar utilizando o formato HTTP.

Ao lado estão alguns exemplos de codificação:

“messageText”:“A combinação foi perfeita :)”

Ou você pode escapar os caracteres caso queira:

“messageText”:“A combina\u00e7\u00e3o foi perfeita :)"