Limites e preço

O que cabe em uma requisição, quantas integrações seu workspace comporta e quanto custa cada segmento enviado.

Limites

Tamanho da mensagem160 caracteres

Contados depois de substituir as variáveis do modelo.

Destinatários por requisição1.000

Vale para a rota de utilidade. Na de autenticação, 100.

Chaves de API por workspace20

Revogue e crie de novo sem mexer nas outras.

Webhooks por workspace10

Cada evento tem até 6 tentativas.

Caracteres aceitos

A rede entrega letras sem acento, números, espaço, quebra de linha e a pontuação do teclado — vírgula, ponto, ponto e vírgula, dois-pontos, interrogação, exclamação, parênteses, hífen, cifrão e afins.

Letras acentuadas e emojis não são aceitos: eles chegam embaralhados no aparelho e dobram o consumo de créditos, então POST /v1/sms os recusa com 422 validation_error antes de cobrar qualquer coisa. O mesmo vale para o nome do remetente e para os modelos — um modelo com acento é recusado ao ser salvo, não na primeira campanha.

{
  "error": {
    "code": "validation_error",
    "message": "O caractere ç não chega ao celular. Envie apenas letras sem acento, números e pontuação.",
    "status": 422,
    "details": [{ "field": "text" }],
    "request_id": "req_2c7v9q"
  }
}

Escreva Promocao no lugar de Promoção. No console, o editor avisa enquanto você escreve e remove os caracteres em um clique.

Como o preço é calculado

Um crédito por segmento, por destinatário. Como o texto para em 160 caracteres, na prática é um crédito por destinatário: um segmento GSM-7 cabe exatamente 160. A exceção são os caracteres que a operadora conta em dobro — [ ] { } ~ ^ | \\ —, que podem levar uma mensagem de 160 caracteres a dois segmentos. A resposta de POST /v1/sms traz segments e credits já calculados, e envio recusado não cobra nada.