API de SMS: Lista completa de tarefas numa integração

30/09/20266 min

Escrito por Francisco Felipe Jimeno, Gestor de Produto na LINK Mobility Spain

Integrar uma API de SMS para o envio de notificações via API é relativamente simples para um programador. No entanto, uma integração não se limita à criação de linhas de código. Há uma série de fatores que são relevantes na escolha de um bom fornecedor de SMS.

Vamos analisar quais são os fatores mais relevantes na escolha de uma API de SMS, ao mesmo tempo que fornecemos uma lista completa de tarefas para que não se esqueça de nenhum ponto do processo.

Análise preliminar

Lista de requisitos da API de SMS

Não se esqueça dos requisitos que não são diretamente técnicos, mas sim relacionados com o caso de utilização.

Suporte técnico: É ágil? A resolução de dúvidas durante a integração pode dar-nos uma ideia da eficácia que terá quando o serviço estiver em produção.
Países com cobertura: A maioria das mensagens é enviada para um país, mas tem clientes noutros países? É necessária cobertura internacional?
Confirmação de entrega: Precisa de saber a data e a hora em que o SMS foi entregue no telemóvel?
Serviços de certificação. Além de conhecer os dados da confirmação de entrega, talvez precise que essa informação seja certificada.
Remetente: Existe flexibilidade para personalizar o remetente da mensagem?
Mensagens programadas. Se as SMS não forem para envio imediato, mas sim programadas com data e hora.
Capacidade de envio. Os envios serão em massa? De que capacidade de envio necessito?
Mensagens bidirecionais: Precisa de receber respostas às mensagens que envia?
Segurança: O fornecedor cumpre alguma normativa de segurança? O RGPD?
Disponibilidade. O fornecedor oferece algum tipo de SLA?

Verifique se já existe algum módulo de SMS para o seu software

Nós, os programadores, muitas vezes complicamos a nossa vida. É possível que já exista um conector para enviar SMS através do nosso software. Nesse caso, não é necessário fazer um desenvolvimento personalizado; a tarefa de integração pode recair sobre um especialista na ferramenta em questão e não sobre o departamento de TI.

Eis uma lista dos conectores mais solicitados:

Salesforce
HubSpot
Zapier
Oracle Marketing Cloud
Adobe Campaign
Emarsys
Shopify
Magento
Microsoft Dynamics 365

Escolha o tipo de API

O tipo de API mais comum é o REST. No entanto, quando o volume de SMS é muito elevado, é aconselhável utilizar SMPP embora o desenvolvimento seja mais complexo do ponto de vista técnico. Se tiver dúvidas, consulte o fornecedor e informe-se bem sobre o protocolo mais adequado ao seu caso de utilização.

Selecione a linguagem de programação

A escolha da linguagem de programação é normalmente determinada pelo projeto em que se está a trabalhar e não pela necessidade específica de uma API SMS.

A API SMS do tipo REST é independente da linguagem de programação e, em todas as linguagens, existem bibliotecas para este tipo de ligação que facilitam o desenvolvimento.

Escolha do fornecedor da API SMS

Condições técnicas

Escolha um fornecedor que lhe transmita uma boa impressão quanto à sua capacidade técnica. Há uma série de indícios que nos podem ajudar:

Consulte a documentação da API. Normalmente, existem parâmetros opcionais que oferecem funcionalidades avançadas.
Fale com o departamento de apoio ao cliente para avaliar a sua capacidade de responder às suas dúvidas.
Que tipo de rotas utilizam? Existem rotas de envio de SMS conhecidas como «rotas cinzentas», que não oferecem garantias suficientes para um serviço de qualidade. Certifique-se de que o fornecedor oferece sempre rotas diretas.

Condições económicas

Que preço oferecem? É óbvio que este é um aspeto muito relevante, mas não é o único. Não se esqueça de que um fornecedor pode oferecer um preço mais baixo, mas estar a utilizar percursos de baixa qualidade.
Existem mensalidades ou anuidades pelo serviço?
Que facilidades de pagamento oferecem?

Condições legais e reputação

Verifique os termos do contrato
Verifique as condições de utilização
Que tipo de clientes já utilizam o seu serviço? Inspiram-nos confiança?

Prova de conceito

Antes de começar, pergunte se existem módulos ou conectores que facilitem ou tornem desnecessária a escrita de código-fonte para a integração.

Comece com um teste, um código-fonte simples para se certificar de que a ligação é estabelecida e que é enviado um SMS através da API com o texto simples «Olá Mundo».

O envio não termina com o pedido; é necessário ler a resposta do fornecedor para confirmar que a mensagem foi recebida corretamente e que não foi emitido qualquer código de erro.

Adicione ao código o fluxo correspondente aos possíveis erros. Separe os erros da API dos erros de comunicação (firewall, proxy, tempo limite de ligação, etc.).

Confirmação de entrega: A confirmação de entrega é assíncrona. Deverá implementar um webhook para receber a informação.

Tempos de espera: O código deve configurar corretamente os tempos de espera aplicáveis ao caso de utilização, para não bloquear o serviço.

Integração do envio de SMS no seu software

Assim que o teste de conceito estiver concluído, integra o código que envia SMS no teu software, seguindo o manual de estilo e as boas práticas de programação e documentação.

Formato dos números de telefone: Uma API de SMS permite enviar mensagens para qualquer país. Se a sua base de dados não contiver os números de telefone no formato com prefixo internacional, é necessário efetuar as adaptações necessárias para que o formato do prefixo internacional corresponda ao esperado pelo fornecedor.

1 SMS = 160 caracteres. Verifique o comprimento das mensagens a enviar para não ultrapassar os 160 caracteres. Se isso não for possível, consulta a API para enviar SMS concatenados, mas lembra-te de que serão faturados tantos SMS quantas forem as partes concatenadas da mensagem.

Conjunto de caracteres: O alfabeto das SMS é limitado. Não permite vogais acentuadas. Se o conjunto de caracteres padrão não for suficiente, lembre-se de que pode enviar SMS Unicode, mas o tamanho máximo da mensagem é reduzido para 70 caracteres.

Controla o fluxo de envio. Se ocorrer um erro no envio, o código tem de decidir se continua com os restantes destinatários ou se envia um alerta para uma revisão manual. É também necessário decidir como são geridos os erros e as novas tentativas.

Testes: Uma boa integração dispõe de testes automáticos para garantir a qualidade do software face às alterações no código.

Contratação

Está tudo pronto; o departamento de compras deve concluir o processo de contratação para obter as credenciais de envio de SMS em produção.

Precisa de ajuda com a integração?

Se precisar do apoio de um especialista e de uma equipa técnica para a integração de um serviço de envio de SMS profissional, rápido e personalizável que se adapte às suas necessidades, contacte-nos através do formulário de contacto, em infocomercial@linkmobility.com ou pelo nosso número de telefone: 912 160 100.