Um serviço de notificações precisa tanto de um meio para enviar textos quanto de uma rota até os telefones dos destinatários. Escolher uma interface resolve apenas a primeira parte desse problema.
O que cada parte faz?
Uma API aceita solicitações programáticas. Um gateway conecta a sua aplicação às redes móveis.
A sua aplicação envia um destinatário, remetente e mensagem pela interface. O gateway encaminha as mensagens para os serviços de rede que fazem a entrega. Um provedor pode fornecer ambas as partes em um único serviço.
A referência de gateway SMPP descreve gateways que conectam aplicações a centros de mensagens móveis. Ela também descreve gateways que oferecem várias interfaces, incluindo HTTP e SMPP.
A interface não determina todas as capacidades de entrega. Um formato de solicitação conveniente não pode tornar válido um remetente não suportado em um destino.
Qual interface devo escolher?
Escolha HTTP para uma aplicação nova, a menos que uma integração SMPP existente ou um requisito específico de conexão justifique gerenciar SMPP.
Com HTTP, a sua aplicação faz solicitações e processa respostas. Ela ainda precisa de tentativas de reenvio, proteção contra envio duplicado e tratamento de eventos de entrega.
SMPP usa uma conexão que permanece aberta. O seu cliente autentica uma sessão e lida com perda de conexão, confirmações e operações de entrada. SMPP explica esse trabalho.
Um sistema SMPP existente pode tornar essa interface uma escolha prática. Teste as operações e limites suportados pelo provedor antes de assumir que outra conexão SMPP se comporta de forma idêntica.
Quais capacidades de entrega devo comparar?
Compare cobertura de destinos, remetentes permitidos, throughput e relatórios de falha úteis com as necessidades da sua aplicação.
- Destinos: confirme o suporte para todos os países que você atende, pois uma rota funcionando não garante outra.
- Remetentes: verifique a disponibilidade e o registro antes de se comprometer com a identidade que os destinatários verão.
- Throughput: diferencie os limites de solicitação da taxa em que o caminho de entrega consegue transportar tráfego.
- Eventos: verifique como mensagens recebidas e falhas de entrega chegam à sua aplicação.
As páginas de destino da Bird publicam requisitos específicos por país. Tipos de remetente explica as opções de identidade.
Por que a entrega chega separadamente da aceitação?
A rede pode concluir a entrega depois que a sua solicitação de envio é completada.
Um centro de mensagens pode reter um texto enquanto o telefone está inacessível. Centros de mensagens explica essa etapa de espera.
Mantenha envio e entrega como resultados separados na sua aplicação. Caso contrário, uma solicitação aceita pode parecer bem-sucedida mesmo quando um relatório de entrega posterior registra falha.
Como envio pela HTTP API da Bird?
Você envia uma mensagem, salva o identificador dela e processa os eventos de entrega que se seguem.
Use POST /v1/sms/messages com to, from, text e category para um envio de texto livre. Defina category como marketing, transactional, authentication ou service. O guia de envio documenta os campos suportados.
Uma resposta 202 confirma a aceitação. Ela não confirma a entrega ao telefone. Acompanhe o id retornado por meio dos eventos SMS para que o resultado final atualize a solicitação correta.
Qual caminho se encaixa na minha aplicação?
Escolha a interface que a sua aplicação consegue operar de forma confiável e depois verifique as capacidades de entrega separadamente.
- Use HTTP para uma nova integração que não tenha um requisito específico de SMPP.
- Use SMPP quando um sistema existente ou um comportamento de conexão necessário justifique o gerenciamento de sessão.
- Teste os destinos, remetentes e eventos de entrega antes de direcionar tráfego para qualquer um dos caminhos.
Em resumo
A API e o gateway desempenham funções diferentes.
A API aceita a sua solicitação, enquanto o gateway fornece o caminho até a rede móvel.
HTTP evita gerenciar uma sessão SMPP.
SMPP exige recuperação de conexão e gerenciamento de sessão além do seu fluxo de mensagens.
Aceitação e entrega permanecem separadas.
Uma solicitação de envio bem-sucedida não comprova que o destinatário recebeu a mensagem.
Compare o caminho de entrega além da interface.
Verifique o suporte a destinos, requisitos de remetente, throughput e relatório de falhas antes de escolher uma integração.