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 uma supressão de remetente e 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-negado: o Bird rejeita envios para qualquer país que seu espaço de trabalho não tenha habilitado. Envio de SMS cobre esse pré-requisito, e Envie seu primeiro SMS orienta você no primeiro envio.

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:

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.

• Envie seu primeiro SMS: uma chave API, um destino, um envio com template integrado e seu status de entrega
• Envio de SMS: o 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 envio por referência de template
• Sender IDs de SMS: como escolher um tipo de remetente e registrá-lo 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 entrega via webhook
• 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 via SMS e e-mail, enviados e validados pelo Bird
• Controlar para onde a sua conta pode enviar: um vídeo que mostra o que um envio para um destino desabilitado retorna