The JSON Orbit sends to your webhook

Orbit sends a POST with this body:

{
  "conversaId": "cv_ig_123",
  "contato": { "id": "123", "nome": "Ana", "username": "ana" },
  "canal": { "handle": "yourshop", "orgId": "org_abc" },
  "mensagem": { "texto": "Hi, how much is it?", "tipo": "text", "url": "" },
  "historico": [ { "de": "cliente", "texto": "..." } ]
}

In n8n, the customer's text is {{ $json.body.mensagem.texto }}.

About the history: it carries the 10 most recent messages of the conversation, oldest to newest, assembled from Orbit's own database — not from Meta. It lets your flow have context without keeping state.

If the customer sent audio, tipo is audio and texto already comes transcribed. The url carries the original file when there is one.

The x-orbit-secret header accompanies every call — validate it in your flow to make sure the request came from Orbit.