Skip to main content
routa.messages cobre o ciclo de vida das mensagens. Cada método corresponde a um endpoint da API REST.

send

Envia texto ou um template aprovado. Retorna a mensagem no estado accepted.
Enviar um template:
accepted não significa entregue. Acompanhe a entrega por webhooks. Veja Acompanhar a entrega.

retrieve

Retorna uma mensagem pelo id.
Os ids são tipos branded: um MessageId é uma string em runtime, mas uma string comum não é atribuível a ele. Veja Tipos e IDs.

list

Lista mensagens com paginação automática. Filtre por direction para ver só as recebidas ou só as enviadas.
Para controlar a paginação manualmente, peça uma página por vez:
Veja Paginação.

markRead

Marca uma mensagem recebida como lida e envia a confirmação de leitura ao remetente.
Para uma mensagem enviada por você, a API responde 422 message_direction_invalid.

O objeto Message

Os campos do SDK são os da API em camelCase. MessageContent cobre também tipos que só chegam em mensagens recebidas ou no histórico (mídia, localização, reação) e unsupported, para que ler uma mensagem nunca lance erro só porque o tipo ainda não é enviável.