Respostas para o seu próximo fluxo de SMS.

Siga o guia de envio com uma chave regional da API, um destino dos EUA habilitado e um remetente adequado dos EUA. Envie para o destinatário sandbox documentado +15005550006 para exercitar eventos de entrega sem contatar um destinatário real. Uma mensagem para o seu próprio telefone é um envio real.

Envie mensagens, receba respostas, gerencie remetentes e destinos e inspecione resultados de entrega. O hub do produto conecta tipos de número, registro, campanhas, analytics e os guias de configuração correspondentes.

Use o catálogo de destinos para verificar cobertura atual, tipos de remetente e requisitos de registro. Habilite o destino no seu espaço de trabalho antes de enviar; apenas ter cobertura não completa a configuração do seu remetente.

Mensagens de aplicação para pessoa nos EUA a partir de números locais de dez dígitos usam registro de marca e campanha 10DLC. Programas toll-free e de short code têm seus próprios requisitos. Escolha o tipo de remetente primeiro e siga o guia de registro correspondente.

Campanha descreve o trabalho de marketing: audiência, conteúdo, agendamento e mensuração. Um broadcast é o recurso de envio que gerencia um envio para uma audiência. O dashboard e a Broadcast API são formas de operar esse fluxo.

Use envios individuais de SMS para notificações acionadas pela aplicação. Use uma campanha para um envio coordenado a uma audiência com conteúdo compartilhado, agendamento e progresso. Um lote de solicitações SMS independentes é uma operação diferente.

Sim. Um contato pode conter identificadores de telefone e email e propriedades compartilhadas. A elegibilidade por canal, consentimento e supressões ainda determinam quais mensagens essa pessoa pode receber.

Não. SMS padrão não reporta aberturas. Confirmações de entrega, respostas, cliques em links configurados e eventos de conversão conectados respondem a perguntas diferentes e devem ser reportados separadamente.

Use um agente para preparar e operar o fluxo por meio das ferramentas e permissões de espaço de trabalho suportadas por Bird. Revise os destinatários e a mensagem, e autorize a ação de envio como parte do seu processo.

Um lote contém até 100 mensagens SMS independentes. Um broadcast direciona uma audiência com conteúdo compartilhado e gerencia preparação, agendamento, progresso e resultados dos destinatários.

A composição é resolvida quando o envio agendado começa. Uma pessoa adicionada ou removida antes disso pode alterar a audiência desse envio. Inspecione o snapshot de destinatários resultante ao investigar a campanha.

O cancelamento interrompe o trabalho que ainda não foi submetido. Mensagens já entregues a uma operadora não podem ser recolhidas, então inspecione os resultados dos destinatários após o cancelamento ser concluído.

Comece com contagens de entrega e falhas. Use sinais de resposta, clique e conversão configurados separadamente para medir a ação que a campanha pretendia produzir. SMS padrão não produz um evento de abertura.

Por mensagem, a uma tarifa que depende do país de destino e do tipo de remetente utilizado, pelo que um código longo dos EUA e um sender alfanumérico do Reino Unido são cobrados separadamente. As tarifas são publicadas por país na página de preços de SMS.

Sim, a faturação é por segmento e não por mensagem. Um segmento contém 160 caracteres GSM-7, ou 70 quando um único emoji ou carácter não latino força toda a mensagem para Unicode. Texto mais longo é dividido e cada segmento é cobrado, pelo que um carácter extra pode duplicar o custo de uma campanha grande.

Taxas das operadoras aplicam-se por mensagem e variam consoante o destino e a operadora. Nos EUA, 10DLC também inclui taxas de registo de marca e campanha. Ambas estão listadas na página de taxas de operadoras de SMS.

O registo de SMS mostra a contagem de segmentos e o custo de cada mensagem individual assim que é tarifada; as métricas de SMS agregam volume aceite, segmentos e gastos ao longo do tempo.

GSM-7 permite 160 unidades para um segmento ou 153 por segmento multipart. Unicode permite 70 ou 67. Caracteres de extensão e emoji podem usar mais de uma unidade, então a contagem visível de caracteres não é suficiente para prever a cobrança.

Bird aceita até 12 segmentos e rejeita um corpo acima do limite. Use a contagem de segmentos baseada na codificação em vez de tratar uma contagem fixa de caracteres visíveis como o limite.

O endpoint de lote aceita até 100 mensagens independentes. Use um fluxo de broadcast quando o trabalho for uma campanha para uma audiência.

Use as informações de limitação de requisições retornadas pela API e a documentação atual da conta. Limites de solicitação da API e throughput da operadora são restrições separadas.

Tipo de remetente, registro, destino e requisitos da operadora afetam o throughput. Planeje com base no programa de envio aprovado e investigue os limites reportados em vez de assumir uma taxa global de mensagens por segundo.

Escolha pelo destino, capacidades necessárias, padrão de tráfego e registro. O tipo de um número descreve sua categoria de rede; suas capacidades indicam se ele pode transportar SMS ou voz.

Não. Propriedade, registro de remetente e destino habilitado são verificações separadas. Um número pode ser alocado enquanto o trabalho de conformidade ainda está pendente.

Não. Short codes são alocados pela Bird por meio de um processo assistido. Consulte um especialista em SMS para avaliar os requisitos de mercado, programa e tráfego.

Sim, quando o número alocado lista ambas as capacidades. Filtre o inventário pelas capacidades de que você precisa e verifique o número retornado; não as deduza apenas pelo tipo.

Uma string curta de marca exibida no campo de remetente do SMS no lugar de um número de telefone. É uma identidade que você reivindica e registra onde necessário, e não um número que aceita respostas.

Não. Use um número com capacidade de SMS quando o fluxo precisar de respostas. Prepare o mecanismo de opt-out adequado para a campanha e o destino.

Apenas onde o destino permite aquele remetente e nenhum registro obrigatório está pendente. Habilite o destino e verifique os requisitos de país do remetente antes do lançamento.

Mensagens toll-free usam um programa de verificação separado. Escolha um número com capacidade de SMS e conclua a verificação toll-free para o caso de uso pretendido.

Não. A aprovação estabelece elegibilidade para o programa. Conteúdo da mensagem, disponibilidade do destinatário, supressões e condições da operadora ainda afetam a entrega.

Um número toll-free com capacidade de SMS pode aceitar respostas quando o destino e a operadora permitirem. Assine os eventos de entrada e revise o tratamento de palavras-chave relevante.

Um 10DLC é um long code de dez dígitos usado para mensagens de aplicação para pessoa nos EUA sob uma marca e campanha registradas. A numeração de long code e o registro diferem em outros países.

Não. Verifique as capacidades do número específico. Alguns números locais suportam voz sem SMS, então filtre o inventário pelas capacidades que a sua aplicação exige.

A vazão depende do destino, da operadora e do programa de registro. Consulte os limites aprovados de marca e campanha para tráfego US 10DLC.

Um short code é um número nacional de mensagens com quatro a seis dígitos. Ele é usado em programas de mensagens revisados e de alto volume e não oferece serviço de voz.

Entre em contato com um especialista em SMS para avaliar o destino, o caso de uso e os requisitos do programa. A Bird aloca short codes; a API de pedidos de números por autoatendimento não os comercializa.

Short codes são nacionais. Verifique o programa local de cada mercado em vez de tratar um código como remetente global.

Para um envio com texto livre, forneça um remetente que seu espaço de trabalho possa usar no destino e a categoria de mensagem apropriada. Um envio por template de sistema resolve a categoria e o remetente a partir do template.

Forneça uma chave de idempotência e reutilize-a ao tentar novamente a mesma solicitação. Um envio sem essa chave pode ser tratado como uma nova mensagem.

Não. Uma resposta 202 significa que a API aceitou a solicitação. Acompanhe o registro da mensagem e os eventos assinados para o resultado reportado pela operadora. Um recibo de entrega não comprova que o destinatário leu a mensagem.

Um lote contém até 100 mensagens independentes, cada uma com seu próprio destinatário e corpo. Um broadcast é uma campanha de audiência com conteúdo compartilhado e um ciclo de envio gerenciado. Escolha o fluxo que corresponde à sua necessidade.

Receba em um número Bird compatível e assine o evento assinado sms.received. Verifique a assinatura do webhook antes de processar o remetente, o número receptor e o texto da mensagem.

Envie do número que recebeu a mensagem para o remetente original. Verifique se o número e o destino suportam a conversa que você está construindo.

Quando o catálogo de palavras-chave do país suporta, STOP cria uma supressão para o par exato remetente/assinante e envia a confirmação configurada. Consulte as regras do país; países não cobertos exigem seu próprio tratamento de opt-out.

A supressão remetente/assinante é restrita a esse par. Preferências de contato do espaço de trabalho são um controle separado e podem ser aplicadas entre remetentes.

IDs de remetente alfanuméricos são apenas para envio. Escolha um número com a capacidade de entrada apropriada e suporte ao destino para SMS bidirecional.

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.

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.

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.

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.

Mensagens entregues são medidas em relação às mensagens aceitas no intervalo de envio selecionado. Envios recentes podem permanecer pendentes enquanto os recibos da operadora chegam.

O cálculo documentado da taxa de falha inclui resultados não entregues, com falha e expirados. O tráfego rejeitado é exibido separadamente, então não deve ser somado a essa taxa sem alterar a definição.

A API de estatísticas expõe detalhamentos separados para dimensões suportadas, incluindo país, operadora e originador. Use os filtros que esse endpoint suporta. Dois relatórios agregados independentes não produzem um resultado combinado de operadora por país.

Um recibo de entrega da operadora reporta a entrega, não uma leitura ou clique. Meça visitas a links e conversões por meio de um link configurado adequadamente e um fluxo de analytics de aplicação.

Abra o registro da mensagem e a linha do tempo de eventos para acompanhar a aceitação, o repasse à operadora e o resultado reportado. Use a API de estatísticas para tendências agregadas e webhooks para eventos na sua própria aplicação.

Uma palavra-chave START compatível pode encerrar a supressão correspondente. Supressões manuais e preferências do espaço de trabalho têm seus próprios controles; não presuma que uma alteração reverte outro tipo de opt-out.

Consulte o recurso de supressão para o assinante e o remetente. Verifique também as preferências do espaço de trabalho ao preparar uma audiência. O envio permanece sujeito aos controles efetivos no momento da submissão.

Um long code dos EUA usa 10DLC para mensagens de aplicação para pessoa. Mensagens toll-free têm um programa de verificação separado. Registros de outros países dependem do remetente e do destino. Leia os requisitos para o remetente que você pretende usar.

Não. Registro do remetente, permissão do cliente e status atual de opt-out são verificações separadas. Preparar um remetente aprovado não concede permissão para enviar mensagens a todos os contatos.

Leia os requisitos de país, o status de registro e se o destino está habilitado. Conclua as próximas ações que Bird reporta antes de lançar o tráfego.

Não. A reivindicação cria a identidade de marca no espaço de trabalho. O registro no país estabelece se aquele remetente está aprovado para o destino que o exige.

Verifique se o registro é obrigatório, qual é o status dele, se o destino está habilitado e quais são as próximas ações. Ter um remetente aprovado não ativa um destino desabilitado.

Consulte a estimativa publicada para o país, quando disponível. Revisão externa e correções solicitadas podem afetar o prazo; use o status em vez de uma data de lançamento presumida.

A marca identifica a empresa. Uma campanha declara um caso de uso sob essa marca. Vincule os números de envio a uma campanha aprovada antes de usá-los para tráfego A2P nos EUA.

O caso de uso registrado não pode ser alterado. Prepare uma nova campanha quando o caso de uso mudar e revise os requisitos e custos antes de enviar.

Não. Conclua a aprovação da campanha, vincule o número e habilite o destino. Uma marca de empresa de capital aberto também exige Auth+ antes do registro da campanha.

Mensagens toll-free seguem seu próprio programa de verificação. O 10DLC se aplica a mensagens A2P por código longo nos EUA.

Sua chamada à Bird é feita via HTTPS, e o webhook de entrada que enviamos a você também. O último trecho não é nosso para criptografar: SMS é um protocolo de operadora sem criptografia de ponta a ponta, e a mensagem é legível no aparelho e pela operadora. Escolha o conteúdo e o canal de acordo com os requisitos de segurança da sua aplicação; e-mail padrão também não é um substituto com criptografia de ponta a ponta.

Cada evento é assinado com HMAC. Verifique a assinatura com o segredo do seu endpoint antes de processar o payload, e faça a rotação desse segredo a partir do painel sempre que necessário.

Na região onde a sua organização está alojada, us1 ou eu1. A sua chave de API contém essa informação no prefixo (bk_us1_…, bk_eu1_…), que é como os SDKs e o CLI selecionam o endpoint correto sem necessidade de configuração.

Uma chave é limitada pelos escopos e níveis atribuídos a ela. Dê a cada aplicação apenas o acesso necessário; uma chave com escopos adicionais pode acessar esses produtos também. Requisitos de função e escopo governam o gerenciamento de chaves no painel e na API.

Ambos. Uma chave aceita uma lista de intervalos CIDR e rejeita pedidos de qualquer outra origem, e a rotação mantém a chave antiga a funcionar durante um período de tolerância (24 horas por defeito, ou zero para a cortar imediatamente) para que a transição não necessite de downtime.

O log de auditoria registra alterações de configuração e segurança da conta com o ator, a ação, o alvo e o horário disponíveis. O tráfego individual de SMS pertence aos logs de mensagens e analytics, então use o registro que corresponde à sua pergunta.

Certificações e documentação de segurança estão disponíveis no Trust Center em trust.bird.com. O acordo de processamento de dados, a declaração de privacidade e a política de utilização aceitável estão publicados em bird.com/legal. Para um questionário de fornecedor, a equipa de conta Bird trata disso.