Introdução

A Routa é a infraestrutura de mensageria para WhatsApp: uma API REST consistente para enviar e receber mensagens sem lidar com a complexidade do provedor.

A Routa é uma plataforma para desenvolvedores que torna a comunicação com clientes simples de integrar e confiável de operar. O primeiro produto, o Routa Messaging, oferece uma API única para enviar e receber mensagens de WhatsApp, sem expor você a autenticação do provedor, webhooks, templates, limites de taxa, retentativas ou payloads específicos de cada fornecedor.

Envie sua primeira mensagem de WhatsApp em menos de 30 segundos. Siga o Início rápido.

import { Routa } from '@routa-chat/sdk'

const routa = new Routa({ apiKey: process.env.ROUTA_API_KEY! })

await routa.messages.send({
  channel: 'chan_...',
  to: '[phone]',
  text: 'Olá! Seu pedido foi confirmado.',
})

O que a Routa resolve

Envio e recebimento

Uma única chamada POST /v1/messages envia texto ou templates. Mensagens recebidas chegam como eventos normalizados.

Entrega rastreável

Cada mensagem percorre um ciclo de vida explícito: accepted, sent, delivered, read ou failed.

Webhooks confiáveis

Eventos assinados com HMAC, entregues ao menos uma vez, com retentativas, reenvio e consulta de eventos perdidos.

Idempotência nativa

Envie o header Idempotency-Key e uma retentativa de rede nunca gera uma segunda mensagem.

Como a Routa funciona

A Routa fica entre a sua aplicação e o provedor de mensageria. O provedor é um detalhe interno: a API pública nunca expõe seus payloads nem seus códigos de erro.

Sua aplicação  ──►  API da Routa  ──►  Provedor (WhatsApp Cloud API)  ──►  WhatsApp  ──►  Cliente final
      ▲                  │
      └── webhooks ◄─────┘   eventos normalizados: message.sent, message.delivered, message.read…

Duas ideias orientam o desenho da API:

• Aceitar não é entregar. POST /v1/messages responde 202 Accepted quando a mensagem foi gravada de forma durável. A entrega é assíncrona e você acompanha cada etapa por webhooks ou por GET /v1/events.
• Nada se perde em silêncio. A Routa absorve limites de taxa, filas, falhas do provedor e retentativas. Falhas permanentes viram eventos observáveis.

Por onde começar

Início rápido

Crie uma chave de API e envie sua primeira mensagem.

Autenticação

Chaves de API, escopos e boas práticas de segurança.

Referência da API

URL base, formatos, paginação, erros e todos os endpoints.

SDK para Node.js

Cliente oficial em TypeScript, com tipos estritos e retentativas automáticas.

O que a Routa não é

A Routa é infraestrutura. Não é um CRM, uma agência, um construtor de chatbots, uma plataforma de marketing nem um simples wrapper de provedor. Produtos da MultiON, incluindo o CRM, consomem os mesmos contratos públicos que qualquer outro cliente.