PEPINO ZAPdocs
Referência da APIInbox

Puxa o historico anterior de uma conversa

Ver como Markdown
POST
/v1/inbox/conversations/{id}/history

Dispara, de forma ASSINCRONA, a importacao do historico ANTERIOR de uma conversa: a plataforma pega a mensagem mais antiga que ja tem (a ancora) e pede ao WhatsApp o lote imediatamente anterior (~50 mensagens). As mensagens chegam depois e populam o Inbox — releia com GET /v1/inbox/conversations/{id}/messages (paginando com before) para ve-las. Util quando a instancia foi conectada SEM importar historico (ver a configuracao importHistory em PATCH /v1/instances/{id}/settings) e voce quer trazer conversas anteriores sob demanda. Requer a instancia CONECTADA. Limite do WhatsApp: ele entrega uma janela recente, nao e garantido "tudo de sempre".

Authorization

bearerAuth
AuthorizationBearer <token>

API key enviada como Authorization Bearer pzk_live_... ou pzk_test_...

In: header

Path Parameters

id*string

Identificador da conversa.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/inbox/conversations/string/history"
{
  "requested": true
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key ausente ou invalida"
  }
}
{
  "error": {
    "code": "FORBIDDEN",
    "message": "Projeto inativo ou sem permissao"
  }
}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Instancia nao encontrada"
  }
}
{
  "error": {
    "code": "CONFLICT",
    "message": "limite de numeros do plano atingido — adicione um numero em \"Meu plano\""
  }
}