Conversas e mensagens

curl "https://sua-instancia.whatix.cloud/wapi/v1/conversations?status=open&pageSize=50" \
  -H "Authorization: Bearer wtx_live_SEU_TOKEN"

curl "https://sua-instancia.whatix.cloud/wapi/v1/conversations/482/messages?pageSize=100" \
  -H "Authorization: Bearer wtx_live_SEU_TOKEN"

curl -X POST https://sua-instancia.whatix.cloud/wapi/v1/conversations/482/messages \
  -H "Authorization: Bearer wtx_live_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Já verifiquei, segue a resposta.", "quotedMsgId": "wamid.HBg...ABC" }'

​

Como saber o que mudou

• Consulte GET /v1/conversations?status=open periodicamente (a cada 15–30s para algo perto de tempo real, a cada alguns minutos para um painel).
• Para uma conversa específica que você já acompanha, releia GET /v1/conversations/{ticketId}/messages e compare pelo id/createdAt da última mensagem que você já processou — não existe parâmetro updatedAfter para filtrar só o que mudou, então a comparação é feita no seu lado.
• Respeite o rate limit de 120 req/min por token: se você faz polling de muitas conversas, distribua as chamadas no tempo em vez de disparar tudo de uma vez. Veja Erros e limites.

let ultimoIdVisto = null;

async function verificarNovasMensagens(ticketId) {
  const r = await fetch(
    `https://sua-instancia.whatix.cloud/wapi/v1/conversations/${ticketId}/messages?pageSize=20`,
    { headers: { Authorization: "Bearer wtx_live_SEU_TOKEN" } }
  );
  const { messages } = await r.json();
  const novas = ultimoIdVisto
    ? messages.slice(messages.findIndex((m) => m.id === ultimoIdVisto) + 1)
    : messages;

  if (messages.length) ultimoIdVisto = messages[messages.length - 1].id;
  return novas;
}

setInterval(() => verificarNovasMensagens(482).then(console.log), 20_000);

​

Erros comuns