HarborOrganizationWorkspacesProductionSandbox
Delivery agent
API key · Customer operations teamALAlex Lee AdminPermissions updated
O caminho do
envio ao aparelho.
Alcance clientes por meio de uma única API de envio enquanto Bird gerencia a conectividade com operadoras. Escolha destinos suportados e o remetente adequado, depois acompanhe o resultado de entrega reportado. Investigue falhas por país ou operadora quando uma rota, destinatário ou registro precisar de atenção.
A rota por trás da sua mensagem
Fluxo de envio
01
Sua aplicação
Escolha o destinatário, o remetente, a categoria e a mensagem.
02
Verificações de destino e remetente
Use um mercado habilitado e o registro necessário.
03
Entrega à operadora
Bird envia a mensagem por meio das suas conexões com operadoras.
04
Um resultado reportado
Acompanhe o recibo nos registros de mensagem, webhooks e analytics.
Um fluxo conceitual. Aceitação, entrega à operadora e recibo de entrega descrevem estágios diferentes do ciclo de vida da mensagem.
A camada sobre a qual o seu envio viaja.
O roteamento fica abaixo da Bird SMS API. Bird verifica o destino e o remetente antes da aceitação, depois envia a mensagem preparada para o transporte da operadora. Inspecione a operadora reportada e o resultado ao decidir se deve investigar um problema de remetente, destino ou destinatário.
Entenda as decisões antes da entrega à operadora.
Elegibilidade, preparação da mensagem e envio à operadora têm papéis distintos.
- 01
Conectividade com operadoras.
Bird gerencia as conexões com operadoras por trás do seu envio. Use o catálogo de destinos para verificar os tipos de remetente suportados e os requisitos de registro para os mercados que você atende.
- 02
Um remetente e destino preparados.
Tipo de remetente, regras de destino e registro determinam qual originador pode ser usado. Uma configuração válida é estabelecida antes de a mensagem ser enfileirada para transporte.
- 03
Informações da operadora quando disponíveis.
O processamento pode resolver a operadora do destinatário para precificação. Uma consulta ausente ou falha recorre à precificação por país. Informações da operadora em um recibo também podem estar ausentes; evite inferir uma rede apenas pelo prefixo do número.
- 04
Recibos de entrega como evidência da operadora.
Um recibo de operadora pode reportar entrega ou um resultado final de não entrega. Algumas mensagens permanecem aguardando um recibo, e campos de operadora ausentes são desconhecidos. Leia a linha do tempo do evento junto com o status atual.
- 05
Discuta os requisitos de rota para uma implantação.
A solicitação pública de SMS não oferece um seletor de rota por menor custo versus maior qualidade. Discuta a combinação de destinos, requisitos de remetente e throughput com um especialista em SMS ao planejar tráfego maior.
Um resultado de entrega que você pode investigar.
Uma jornada SMS bem-sucedida depende do destino, do registro do remetente, do conteúdo da mensagem e do caminho da operadora. Bird reúne essas decisões em um único fluxo de envio. Comece pelos requisitos do destino, depois use os registros de mensagem e os resultados da operadora para identificar o que precisa mudar.
O recibo de entrega, diretamente do operador.
Uma solicitação bem-sucedida retorna 202 antes da entrega pela operadora. Eventos subsequentes podem incluir a operadora reportada e o MCC/MNC. Trate campos ausentes como desconhecidos e inspecione a linha do tempo da mensagem para a evidência disponível.
POST /webhooks/bird
signed
{
"type": "sms.delivered",
"timestamp": "2026-05-19T15:42:01.221Z",
"data": {
"sms_id": "sms_4kT01Lq2m",
"workspace_id": "ws_8KQ2",
"to": "+15005550006",
"from": "+12025550188",
"tags": null,
"metadata": null,
"carrier": "Verizon",
"mcc_mnc": "311480",
"cost": {
"amount": "0.0079",
"currency_code": "USD",
"transaction_amount": "0.0079",
"passthrough_amount": null
}
}
}
Os campos de operadora e MCC/MNC são reportados quando disponíveis. Uma diferença em relação às expectativas baseadas em prefixo é motivo para investigar; por si só, não prova portabilidade numérica.
sms.deliveredO operador confirmou que o telemóvel recebeu a mensagem (DLR).sms.failedA operadora rejeitou ou não conseguiu entregar, com o motivo anexado.
O encaminhamento apoia-se na inteligência de números.
Use Lookup quando sua aplicação precisar de inteligência de número de telefone suportada. Inscreva-se em webhooks para resultados de SMS e use a referência de erros e o guia de entregabilidade para interpretar falhas reportadas. Um resultado de consulta não estabelece elegibilidade do remetente nem garante entrega.
Perguntas antes de começar
Como verifico a cobertura de destinos?
Abra o catálogo de destinos e consulte os tipos de remetente e os requisitos de registro de cada mercado. Seu espaço de trabalho também precisa permitir o destino antes que um envio seja aceito.
O que um recibo de operadora comprova?
Ele relata o resultado de entrega da operadora. Recibos podem chegar após a aceitação, e o registro da mensagem ainda pode estar pendente. Entrega não mede se alguém leu ou agiu com base na mensagem.
Como devo investigar uma rota com falha?
Comece pelo status da mensagem e pelo motivo da falha. Compare relatórios por operadora, país ou remetente e depois verifique o registro e a configuração de destino. Uma taxa agregada de falha, por si só, não identifica a causa.
Posso inspecionar um número de telefone separadamente?
Use o Lookup quando sua aplicação precisar de inteligência sobre o número antes de enviar. Consulte os sinais e a disponibilidade dessa consulta em vez de tratar um relatório de entrega de SMS como uma verificação completa do número.
O resto da plataforma de SMS
Uma API, um único conjunto de chaves. Explore as outras capacidades.
EnvioA API de envio: segmentos, segurança Unicode, lotes e idempotência.NúmerosLong codes, short codes, toll-free e sender IDs alfanuméricos.BidirecionalSMS recebidos e respostas conversacionais como webhooks assinados com HMAC.ConformidadeRegistro A2P 10DLC, palavras-chave de opt-out e regras de sender-ID.AnalíticaResultados de entrega, motivos de falha e latência dos recibos de operadora.Visão geral da API de SMSA API de SMS completa: envio, números, bidirecional, conformidade, encaminhamento e analítica.Biblioteca de recursos SMSEncontre guias, respostas explicadas e ferramentas para o seu próximo passo.
Escale sem
perder o controle.
Organize equipes em espaços de trabalho, controle o acesso à API e rastreie alterações nos logs de auditoria.
HarborOrganizationActive
Audit log
Production- Workspace
- Production
- Resource
- Delivery agent
- ReadRead & write
Team Customer operationsActor role AdminOutcome SucceededTime 22 Sep, 09:42:18 UTC
Succeeded