Visão geral do SMS
O Bird SMS envia mensagens de texto pela mesma plataforma e chaves API do Bird Email. Chame Bird com uma chave bk_{region}_… no seu host regional (https://us1.platform.bird.com ou https://eu1.platform.bird.com). O Bird escolhe uma rota até a operadora do destinatário, divide o texto em segmentos tarifáveis e reporta cada mensagem por meio do recibo de entrega. Os endpoints SMS começam com /v1/sms/.
Você pode enviar texto livre com um remetente e uma categoria de sua escolha, ou usar um dos templates integrados do Bird, que fornece o corpo, a categoria e o remetente. O Bird também recebe respostas nos seus números. Ele armazena cada mensagem recebida junto com seus envios e emite sms.received. Quando uma resposta corresponde a uma palavra-chave de cancelamento suportada, como STOP, o Bird também registra um bloqueio de novos envios daquele remetente para aquele assinante. Consulte Cancelamentos e palavras-chave para cobertura e configuração.
Como o envio funciona
Envie um SMS com POST /v1/sms/messages: um destinatário e uma mensagem, contendo seu próprio text com remetente e categoria ou uma referência de template com os valores das variáveis. O Bird valida a solicitação e o destino, resolve o remetente e retorna 202 Accepted com um ID de mensagem. A entrega acontece de forma assíncrona. Acompanhe o resultado por meio de eventos e webhooks ou pelos endpoints de leitura de mensagem. Para enviar várias mensagens independentes em uma única chamada, use o endpoint de lote.
Três ideias orientam toda a API:
- Envio e entrega são etapas separadas. Um 202 significa que o Bird aceitou a mensagem. A operadora a processa após a aceitação e pode retornar um recibo de entrega depois. Um recibo de falha também é um resultado final; verifique o status reportado antes de tratar o envio como entregue.
- O texto é tarifado em segmentos. Uma mensagem maior que um segmento é dividida e tarifada por segmento, e a capacidade por segmento depende dos caracteres usados. Limites de caracteres contém as regras de codificação, o conjunto completo de caracteres e como manter as mensagens em um único segmento.
- O motivo do envio importa. Toda mensagem carrega uma categoria: transactional, marketing, authentication ou service. O Bird e as operadoras usam isso para entender a finalidade da mensagem. Em um envio por template, a categoria vem do template.
Antes do primeiro envio, habilite os países de destino que você atende em SMS > Destinations. A lista de permissão padrão começa apenas com o país de origem da sua organização habilitado. O Bird rejeita envios para qualquer outro país. Envio de SMS cobre esse pré-requisito.
Para códigos de verificação de uso único, considere o Bird Verify em vez de compor a mensagem você mesmo. O Verify gera e entrega o código por SMS ou e-mail, verifica a resposta e aplica expiração, limites de tentativas e intervalos de reenvio.
O app SMS no dashboard
No dashboard, o SMS é um dos produtos na barra lateral. Suas páginas e onde o guia de cada uma se encontra:
| Página | Para que serve |
|---|---|
| Messages | Todas as mensagens enviadas, com a linha do tempo de eventos e os detalhes de entrega por mensagem. Guia: Log de SMS |
| Templates | Os templates integrados que você pode enviar: nome, categoria, idiomas e variáveis. Guia: Templates de SMS |
| Metrics | Taxa de entrega, taxa de falha e volume aceito ao longo do tempo. Guia: Métricas de SMS |
| Senders | Os sender IDs e números disponíveis para envio e onde cada um está registrado. Guia: Sender IDs de SMS |
| Destinations | Os países para os quais seu espaço de trabalho pode enviar; habilite um destino antes de enviar para ele. Guia: Envio de SMS |
Visibilidade
Use os registros de mensagem e a linha do tempo de eventos disponível para investigar aceitação, repasse à operadora e resultados de entrega. Os detalhes da mensagem incluem segmentos e componentes de custo com preço disponível. As leituras públicas de mensagem cobrem a janela de retenção descrita no Log de SMS.
- Log de SMS: a visão por mensagem no dashboard. Cada envio, sua linha do tempo de eventos, segmentos, custo e detalhes da operadora.
- Métricas de SMS: a taxa de entrega agregada, taxa de falha, volume aceito e latência de entrega de tudo o que você envia.
- Eventos: o vocabulário de eventos SMS, o ciclo de vida da mensagem e a entrega de webhooks para seus próprios endpoints.
Próximos passos
Explore a plataforma SMS para campanhas, mensagens de aplicação e respostas, ou use a biblioteca de recursos SMS para escolher um fluxo de trabalho.
| Página | O que cobre |
|---|---|
| Envio de SMS | A API de envio: destinos, remetentes, corpo, segmentos, categorias, tags |
| Limites de caracteres | Codificação GSM-7 e UCS-2, limites por segmento e o teto de 12 segmentos |
| Templates de SMS | O catálogo de templates integrados e o envio por referência de template |
| IDs de remetente de SMS | Escolha de tipo de remetente e registro por país de destino |
| Registro 10DLC | Registro de marca, campanha e número para envio A2P nos EUA |
| Log de SMS | Cada mensagem, sua linha do tempo de eventos, segmentos e custo |
| Métricas de SMS | Taxa de entrega, taxa de falha e latência |
| Eventos | Os tipos de evento SMS e a entrega de webhooks |
| Webhooks e eventos | Configuração de endpoint, verificação de assinatura, novas tentativas e replay |
| Visão geral do Verify | Códigos de verificação de uso único por SMS e e-mail, enviados e verificados pelo Bird |
| Controlar para onde a sua conta pode enviar | Vídeo: mostra o que um envio para um destino desabilitado retorna |
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaSMS pumping explainedEntenda o conceitoWhat is SMS pumping, and how do I stop it?Explore a funcionalidadeSMS destinationsSiga o percurso de aprendizagemBuild your first integration
Obtenha um resumo de implementação