O que muda da uazapi

A API uazapi e a API Orkesio falam com a mesma inbox e o mesmo token. A uazapi continua funcionando como hoje, sem data para sair: as rotas e os eventos dela não mudam. A Orkesio é o caminho daqui para frente: a API oficial do WhatsApp, os canais novos e as melhorias saem só nela. Dá para migrar uma parte por vez.

Esta página compara as duas lado a lado. Para entender a Orkesio do zero, comece por Como funciona.

A ideia em uma frase

Um modelo de mensagem único (OrkesioMessage), igual nos eventos, na busca e na resposta do envio, dentro de um envelope único para todos os eventos. Os eventos chegam por GET /events e por webhook. Os webhooks da Orkesio ficam em /webhooks; os da uazapi (/webhook) seguem iguais e separados. Quem quiser os dois formatos cria um webhook em cada rota (pode ser o mesmo link).

Envelope

{
  "id": "evt_01JAB3K9ZQ7V0M4T8R2X6WYD5H",
  "type": "message.received",
  "created_at": "2026-10-17T12:00:00.000Z",
  "inbox": { "id": "r0269625d29bfbd", "name": "loja", "phone": "5511888888888", "channel": "whatsapp_web" },
  "data": { "message": { "...": "a mensagem" }, "chat": { "...": "a conversa" }, "lead": { "...": "o lead" } }
}

Nos eventos de mensagem, o data traz a mensagem (message) e a conversa (chat); message.received e message.sent trazem também o lead (só em conversa direta). Outros eventos têm o data próprio: veja a página de cada um.

As listas de valores podem crescer (type, status, sent_by, channel). Trate valor desconhecido sem quebrar.

Eventos

A mensagem (OrkesioMessage)

O mesmo objeto nos eventos (message.received, message.sent), na busca e na resposta do envio. A explicação campo a campo está em A mensagem.

Classes (campo category)

Na uazapi cada uso deduzia do messageType. Na Orkesio a api manda a classe em cada mensagem (category), e a busca filtra por ela.

Regras decididas

• Miniatura: na mídia (foto, vídeo, documento, figurinha) vem só no aviso em tempo real (/events e webhook); não é gravada, a busca traz o url. Em link, localização, anúncio e convite vem também na busca.
• Reações e votos: continuam uma mensagem cada; na busca, a mensagem reagida traz a soma em reactions e a enquete traz o resultado em results.
• Grupo: chat_id identifica o grupo (e data.chat.name traz o nome); author traz quem escreveu. Sem a informação de admin.
• Status de grupo: message.status leva só o sent/failed da mensagem; cada participante vem em group.receipts.
• Identidade sem telefone: author.id é opaco (no Instagram e no Messenger não há número). O número vem em phone, e o nome de usuário em username.
• Anúncio: referral traz a origem (anúncio, título, link, ctwa_clid), igual na Web e na oficial, e filtra a busca (referral=true ou referral_source_id em GET /messages).

Envio e busca

Duas rotas novas, com o mesmo modelo de mensagem. As rotas atuais (/send/*, /message/find) continuam iguais.

Uma página por tipo, com a uazapi ao lado da Orkesio: Enviar mensagem e Buscar mensagens.

O que um canal não tem responde 501 com error: unsupported_for_channel (template no Web; enquete, carrossel, event e payment na oficial). O detalhe está em Enviar mensagens. Campanhas (/sender) e status (/send/status) têm rotas próprias: /campaigns e /status-posts.

O que já funciona