API de WhatsApp · REST · webhooks · MCP em breve

A API de WhatsApp que entrega o dado certo.

Conecte números pelo QR ou por código de pareamento e envie e receba mensagens por HTTP. Etiquetas, grupos e o telefone real por trás de cada LID chegam completos.

cancele quando quiser · não afiliado à Meta
curl · POST /v1/instances/{id}/messages
curl https://talaria-api.rrlabs.io/v1/instances/ins_8Fq2/messages \
  -H "Authorization: Bearer tk_live_…" \
  -d '{
    "to": "5511987654321",
    "type": "text",
    "text": "Seu horário é amanhã às 14h"
  }'

# 202 Accepted
{ "id": "3EB0A1C2…", "status": "sent",
  "to": { "pn": "5511987654321", "lid": "1203…@lid" } }
O que as outras APIs erram

Numa API de WhatsApp, dado incompleto é mensagem perdida.

LID ↔ telefone

O número real, não só o LID

Cada contato e participante vem com pn e lid. Quando o telefone ainda não é conhecido, dizemos por quê, e ele chega assim que for resolvido. É o que permite reenviar pela API oficial da Meta.

Etiquetas do Business

Etiquetas como no celular

Lemos as etiquetas da sincronização do app: nome, cor e cada conversa associada, incluindo as antigas, e as remoções também.

Grupos e comunidades

Grupos com endereço certo

Grupos e comunidades com tamanho e endereçamento (telefone ou LID), e cada participante com pn e lid quando o WhatsApp os dá.

Estado real da sessãoConectada, sincronizando, aguardando QR, desconectada: com o motivo, em cada consulta e no evento session.state.
Todo tipo de mensagemTexto, imagem, vídeo, áudio, documento, localização, contato e reação, com digitação simulada.
Webhooks assinadosStandard Webhooks ou X-Webhook-Hmac, novas tentativas por 24 h e reenvio pelo painel.
Registro de eventosSete dias de eventos com cursor: leia o que perdeu, quando quiser.
Multi-instânciaCrie instâncias pela API para os seus clientes; chaves da conta ou de uma instância só.
MCP para agentes em breveSeu agente de IA lê e responde conversas com as permissões da chave.
Três passos

Do cadastro à primeira mensagem em minutos.

  1. Crie a conta e escolha um plano ou o teste grátis.
  2. Leia o QR com o WhatsApp do celular, ou use o código de pareamento.
  3. Envie pelo playground e copie o código gerado para o seu sistema.
Abrir o playground
POST /v1/instances/{id}/messagesconectada
resposta · 202
{
  "id": "3EB0A1C2D3E4F5A6B7C8D9",
  "status": "sent",
  "to": { "pn": "5511987654321", "lid": "1203…@lid" },
  "client_ref": "pedido-42"
}

O mesmo id volta em message.sent e message.status (server, delivered, read).

Preço por número conectado.

Sem cobrança por mensagem. Os planos e preços vêm do nosso checkout (Business Hub).

Parceiro

Sob consulta

Instâncias para os seus clientes, volume, servidor dedicado.

Falar com vendas

Perguntas frequentes

O Talaria é a API oficial do WhatsApp?

Não. O Talaria conecta o seu número como um aparelho do WhatsApp Web: é uma API de WhatsApp não oficial e não é afiliado à Meta. Para volume alto em números novos, combine com a API oficial; o Talaria entrega o telefone real de cada contato para isso.

Meu número pode ser banido?

Pode, como em qualquer integração não oficial. Envie para quem espera a sua mensagem, use digitação simulada e um ritmo humano; não prometemos risco zero. Quando o WhatsApp bane, a instância diz banned, com o motivo.

Vocês guardam minhas mensagens?

Guardamos o necessário para a API funcionar: o registro de eventos (com o conteúdo das mensagens) por 7 dias, e as entregas de webhook até serem aceitas, por no máximo 24 h de tentativas. Tudo cifrado em repouso. O modo selado (o conteúdo cifrado com a chave da sua aplicação) vem em breve.

O que acontece se o celular desconectar o aparelho?

A instância passa a desconectada com o motivo (phone_unlinked), você recebe session.state no webhook e reconecta pelo QR ou pelo código, sem perder a instância nem as chaves.

Posso conectar números de clientes meus?

Sim, com o consentimento deles: crie uma instância por número pela API e use chaves limitadas a cada instância. Veja o uso aceitável.