4 MINDS

Sistema para Gestão de Conhecimento

MViral - Enviando mensagens pela API


Nesse artigo vamos ver como podemos enviar mensagens por sms pela API do MViral.
Podemos resumir essa tarefa em 3 etapas:
  1. Realizar autenticação, veja esse artigo
  2. Enviar a requisição http
  3. Analisar a resposta
Passo 1
Para autenticar-se e poder utilizar os serviços da API , veja esse artigo que demonstra um passo-a-passo para obter permissão de acesso aos serviços da API. Sem realizar essa etapa com sucesso, não será possível utilizar o serviço.

Passo 2, enviar requisição http
O serviço de envio de mensagens espera uma requisição http com essas informações:
  • Formato: POST
  • URL: https://www.mviral.com.br/api/dispatch
  • Tipo de dados: form-urlencoded (Content-type: x-www-form-urlencoded)
  • Parâmetros obrigatórios: text, numbers, type, from
Os parâmetros obrigatórios:
  • text: a mensagem sms que deseja enviar
  • numbers: os números que devem receber a mensagem, separados pelo caractér ',' (vírgula)
  • type: deve ser um desses valores; CORPORATIVO, MARKETING
  • from: nome do remetente da mensagem. Esse nome será adicionado ao inicio da mensagem para garantir que a mensagem irá com o nome de um remetente
Importante: se a mensagem exceder 150 caractéres, ela será reduzida para não ultrapassar esse limite.
Por exemplo, utilizando o programa curl para enviar um requisição http POST, uma requisição para a API poderia ser assim:
curl --insecure -i -X POST -H "X-Auth-Token:seu-token-aqui" -d 'numbers=99008894,99767081&text=Sms de teste&type=MARKETING&from&Mobile Mind' https://www.mviral.com.br/api/dispatch
Passo 3
Em caso de sucesso, a API irá responder:
HTTP/1.1 200 OK
Date: Wed, 27 Aug 2014 15:35:35 GMT
Server: Apache/2.4.6 (Ubuntu)
Content-Length: 7
Content-Type: text/html;charset=UTF-8

success
Em caso de erro, a API responde com http status 400, por exemplo:
HTTP/1.1 400 Bad Request
Date: Wed, 27 Aug 2014 15:37:44 GMT
Server: Apache/2.4.6 (Ubuntu)
Content-Length: 64
Connection: close
Content-Type: text/html;charset=UTF-8

Parameters missing. Make sure to send all of these: numbers,text,type,from
Verifique a mensagem de erro para descobrir o motivo do status 400.
Em caso de dúvidas ou dificuldades, entre em contato através do e-mail suporte@mobilemind.com.br.