Como enviar SMS via API

Índice:

1. Disparo de SMS via API

2. Boas Práticas do Canal SMS

Disparo de SMS via API

O processo de envio de SMS via API é bem simples. Siga os passos a seguir para realizar o seu disparo:

Obs.: Imagens e vídeos: são enviados por meio de um link que redireciona para a imagem/vídeo enviado. 

Antes de enviar sua mensagem, se atente ao número de caracteres e aos caracteres especiais da sua mensagem, visto que para cada quantidade de mensagem há um tipo de cobrança.

O texto de um SMS pode conter até 160 caracteres, porém ao usar caracteres especiais, todos os caracteres das mensagens vão ser contados de uma forma diferente e o limite da mensagem passa a ser 70 ao invés de 160.

Exemplo de limite de caracteres

Exemplos de palavras e seu número de caracteres devido ao uso de caracteres especiais, note que esses caracteres estão em negrito:

Segue abaixo, um exemplo de envio de mensagem com seu número de caracteres e a quantidade de mensagens devido ao uso de caracteres especiais.

(Tabela de caracteres considerados como “não especial”)

1) Requisições 

Para enviar um disparo via API é necessário que você acesse algum aplicativo de requisições HTTP, por exemplo o Postman . Caso não tenha instalado, você pode acessar aqui: 

Além disso, apenas para fins de informação, a maioria das requisições dessa documentação vão possuir os campos abaixo:

Observação: no campo “to” é obrigatório incluir o “+” antes do DDI, uma vez que o “+” é utilizado para SMS internacional.

Para gerar o id das requisições abaixo, você pode gerar manualmente ou por meio de um gerador gratuito de GUID.  

• Link da Guideline do GUID pela Microsoft: Guid.NewGuid Método (System) | Microsoft Docs
• Link do gerador online e gratuito de GUID: Free Online GUID Generator

2) Disparo individual

Caso deseje enviar um SMS para apenas um número, seu disparo será individual. 

1. Primeiro, utilize a requisição ‘Send a Message’. Você pode acessar mais detalhes sobre essa requisição em: Blip Docs | API Reference
2. Modifique o campo ‘to’ para o seguinte padrão abaixo.  Esse campo indica para quem você deseja enviar a mensagem:

4) No campo ‘content’, que representa o conteúdo da mensagem, adicione o texto da mensagem desejada.

5) Selecione a opção “POST” para definir o tipo de requisição e envie. 

6) Sua requisição seguirá o seguinte modelo:

6) Pronto, você realizou um disparo de SMS via API!

3) Múltiplos Disparos:

Caso deseje enviar um SMS para vários números, seu disparo será para múltiplos contatos.

• Crie uma lista de distribuição usando a requisição ‘Create a List’, método POST. Você pode acessar mais detalhes sobre essa requisição em: Blip Docs | API Reference
• Com a lista criada, adicione os usuários que deseja impactar usando a requisição ‘Add a member to a list’ (Adicione um membro em uma lista) seguindo o formato abaixo.  Você pode acessar mais detalhes sobre essa requisição em:  Blip Docs | API Reference. 

•  Para enviar a mensagem, use a requisição ‘Send a message’ com o nome completo da lista criada no campo ‘to’ e o conteúdo da mensagem no campo ‘content’. você pode acessar mais detalhes sobre essa requisição em:  Blip Docs | API Reference.

Pronto, você realizou um disparo de SMS via API!

Boas Práticas do Canal SMS

1) Ative SMS em um chatbot exclusivo para SMS

Para facilitar o controle de mensagens, indicamos que o fluxo de SMS seja exclusivo para um chatbot de SMS, ou seja, não é recomendado ativar SMS num chatbot que tenha fluxo do WhatsApp. Nesse caso, crie um chatbot a parte apenas para o fluxo de SMS.

Caso você ative o SMS num chatbot que tenha fluxo de WhatsApp e acione um componente interativo, como por exemplo: botões ou conteúdos dinâmicos, como esses componentes não existem no SMS e ambos os canais estão utilizando o mesmo fluxo, o componente não será enviado no formato esperado e ainda poderá ser cobrado uma quantidade maior de mensagens devido à quantidade de caracteres que esse comportamento irá gerar. Dessa forma, a mensagem não funcionará da forma prevista, será muito extensa e ainda vai possuir vários caracteres especiais que serão contabilizados financeiramente.

Imagens e vídeos: são enviados por meio de um link que redireciona para a imagem/vídeo enviado.

2) Para enviar somente mensagens ativas não é necessário fluxo de chatbot

Caso você queira somente enviar mensagens para o seu usuário, sem necessidade de receber as respostas dessa mensagem, basta realizar sua ativação de SMS num chatbot que não possua fluxo no Builder. Caso esse fluxo exista, esperando respostas do usuário e dando prosseguimento à “conversa" entre o cliente e o chatbot, haverá a contabilização do pagamento devido a continuidade de mensagens enviadas.

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃