Perguntas e respostas sobre a API de SMS em massa

Uma API de SMS em massa para desenvolvedores: envie um texto ou um lote de até 10.000 números por solicitação para 227 países via REST, acompanhe cada mensagem com webhooks assinados e pague por mensagem a partir de um saldo pré-pago. Um console web envia campanhas de uma lista colada ou CSV sem código.

Equipes de produto e engenharia que enviam textos de seus próprios sistemas: códigos de login e cadastro, atualizações de pedidos e entregas, lembretes de compromissos, alertas de pagamento, avisos de serviço e campanhas de marketing. Qualquer pessoa que possa fazer uma solicitação HTTPS pode usá-la.

227 países e territórios, listados com seus preços na página de preços e nas páginas de países. Uma solicitação pode misturar países: cada número é precificado pelo país ao qual pertence.

Não. Você paga por segmento de mensagem a partir de um saldo pré-pago, e não há taxa mensal, taxa de configuração ou volume mínimo. O saldo não tem data de expiração.

As contas começam com saldo zero e a primeira recarga abre tudo. A primeira recarga adiciona um bônus de até 40%, então as primeiras mensagens custam menos. Os preços são públicos, e o endpoint de estimativa e o console mostram o custo exato antes de qualquer envio.

POST /v1/batches aceita até 10.000 números por requisição, com um texto para todos ou um texto personalizado por número. O console aceita 50.000 números por campanha. Listas maiores são divididas em várias requisições.

A fila é processada a cada dois segundos e envia até 1.200 mensagens por minuto por conta para a rede, na ordem em que foram aceitas. Uma única mensagem geralmente é enviada em alguns segundos após a requisição.

E.164 internacional: um sinal de mais, o código de discagem e o número nacional, como +14155550123. Espaços, hífens, colchetes e o prefixo 00 são removidos automaticamente; duplicatas e números que não podem ser lidos são separados e não são cobrados.

Até 10 segmentos: 1.530 caracteres em GSM-7 ou 670 em Unicode. Um segmento contém 160 caracteres GSM-7 ou 70 Unicode; textos maiores são divididos em partes de 153 ou 67 caracteres e reunidos no celular.

Um caractere fora do alfabeto GSM-7, como uma aspas curva, um emoji ou uma letra como á ou ç, converte todo o texto para Unicode com 70 caracteres por segmento. O editor do console identifica esses caracteres, e POST /v1/estimates retorna a codificação antes do envio.

Sim. Adicione send_at a uma requisição de API ou escolha um horário no console, de 2 minutos a 45 dias no futuro. Um lote agendado pode ser cancelado até começar, e seu custo total é devolvido ao saldo.

Sim. Pela API, envie um lote com mensagens, um {to, text} por destinatário. No console, cole ou faça upload de uma lista com colunas extras e use campos de mesclagem {{1}} a {{9}} no texto.

Defina seu texto de cancelamento em Configurações, como um link ou e-mail, e o console o adiciona aos textos de campanha quando marcado. Pela API você controla o texto completo, então adicione a linha manualmente em mensagens de marketing. Números na lista de não-envio são ignorados pelo console e API, sem cobrança.

Sim. O console tem um envio de teste para um número antes da campanha, e pela API você pode enviar uma mensagem única para seu próprio telefone com POST /v1/messages.

Cada mensagem passa de enfileirada para enviada, depois entregue ou falha. Adicione uma URL de webhook no console para receber um evento assinado para cada status final, ou consulte GET /v1/messages/{id} e GET /v1/batches/{id}.

No formato Standard Webhooks: cabeçalhos webhook-id, webhook-timestamp e webhook-signature, onde a assinatura é HMAC-SHA256 do id, timestamp e corpo bruto com seu segredo whsec_. A documentação tem código de verificação para Node.js, Python, PHP e Go.

Cada evento tem 10 tentativas em cerca de 24 horas, e cada tentativa é listada no console com seu status HTTP. Você também pode consultar os endpoints de mensagem a qualquer momento.

O celular pode estar desligado por muito tempo, o número pode não estar mais em serviço ou a rede pode recusar a mensagem. O status de falha inclui um código de erro, e o valor é reembolsado.

Lotes, mensagens e o registro de saldo permanecem em sua conta e na API. O log de requisições mantém suas últimas 500 chamadas API e o log de webhooks mantém suas últimas 500 entregas.

Sim. No console, cole números ou faça upload de um arquivo CSV com até 50.000 linhas, escreva o texto com campos de mesclagem, verifique a prévia para cada destinatário e o custo por país, e envie agora ou em um horário agendado.

Saldo, lotes recentes com contagens em tempo real, cada lote com suas mensagens e status, recargas e o histórico, chaves de API, configurações e entregas de webhooks, o log de solicitações, a lista de preços, tickets de suporte e configurações.

Na página de Suporte do console. Dúvidas sobre pagamento podem ser enviadas desde o primeiro dia; os outros tópicos são liberados após a primeira recarga ser creditada.