Guias

Como isso realmente funciona

As partes da mensageria que é fácil errar sutilmente: o que é um segmento, onde o limite de taxa realmente vive, por que uma mensagem aceita não é uma entregue. Escrito a partir do que a plataforma faz, não do que soaria bem.

4 min

Traga sua própria conta

A plataforma não tem conta de provedor própria. Essa única decisão de design muda quem é dono dos números, quem detém a cota e quem aparece na fatura.

Ler o guia →
5 min

Segmentos de SMS e o que você realmente paga

O SMS é cobrado por segmento, não por mensagem. Caber em um único segmento depende do conjunto de caracteres necessário — e da codificação que você definiu na conexão.

Ler o guia →
7 min

Tratamento de opt-out

O opt-out tem duas metades: o registro de supressão e a checagem que roda antes de uma mensagem de marketing ser entregue ao provedor. Ambas passam por uma normalização compartilhada, que é justamente a parte que costuma quebrar.

Ler o guia →
5 min

Lendo um recibo de entrega

Um recibo é uma sequência de estados, não um veredito. Tratar um estado intermediário como final é a forma mais comum de um painel de envio acabar mentindo para você.

Ler o guia →
5 min

Ritmo, cotas e por que enfileiramos

Cada conexão tem uma taxa de envio. A plataforma enfileira respeitando essa taxa em vez de disparar tão rápido quanto o provedor aceita, porque o jeito mais rápido de ser limitado é enviar justamente na velocidade que provoca o limite.

Ler o guia →
4 min

Roteamento e failover

As rotas são ordenadas por prioridade e ponderadas dentro de uma conexão. A ideia é que um provedor recusando envios resulte em envio mais lento, não em silêncio.

Ler o guia →
4 min

Quem decide se uma mensagem é marketing

A plataforma pede que você declare que tipo de mensagem está enviando, em vez de inferir isso do texto. Esse único campo decide se o filtro de opt-out se aplica — e a honestidade da declaração é sua.

Ler o guia →
4 min

Um timeout não é uma falha

O envio é aceito de forma assíncrona e não há chave de deduplicação. Repetir uma requisição sobre a qual você tem dúvida envia uma segunda mensagem e a cobra.

Ler o guia →
4 min

Dois endpoints que parecem iguais e não são

Recibos de entrega e respostas recebidas são endpoints diferentes, configurados em lugares diferentes no console do seu provedor. Configurar apenas a URL de recibos faz o tratamento de opt-out parar — em silêncio, sem erro algum.

Ler o guia →
3 min

Recuperar um número

Quem fez opt-out pode voltar a autorizar. A plataforma desativa o registro de supressão em vez de apagá-lo, para que o histórico de consentimento sobreviva.

Ler o guia →
4 min

O que acontece quando seu callback está fora do ar

Os resultados finais são enviados para uma URL que você controla, com um número pequeno e limitado de tentativas. Seu handler precisa tolerar repetição e não deve esperar uma chamada para cada mensagem.

Ler o guia →
3 min

Qual limite de taxa você acabou de atingir

Há dois limites antes de um envio: o que seu plano define e outro bem mais alto na borda da rede. Ambos respondem com o mesmo código de status, então é o texto da mensagem que os distingue.

Ler o guia →
3 min

Quem o destinatário realmente vê

Se você não informa um remetente, a plataforma escolhe um da conexão que leva a mensagem. Informar um explicitamente tem prioridade em todo lugar.

Ler o guia →
3 min

O que a plataforma não guarda

O conteúdo das mensagens não é arquivado. O que fica são metadados — e entre eles dois campos são estruturais, porque sem eles uma fatura não poderia ser conciliada.

Ler o guia →
Escopo. Estes guias percorrem o canal de SMS do primeiro contato à produção. O e-mail e o WhatsApp funcionam no mesmo modelo de conexão — escolha um provedor, vincule sua conta, envie pelo console.