ReferenciaConversations
Conversations
Inbox público. La misma visibilidad del producto para el usuario que creó la clave.
Lista hilos, lee mensajes, responde texto, cierra, pospone, prioriza, anota, etiqueta e invita staff.
| HTTP | Path | Scope |
|---|---|---|
| GET | /api/v1/conversations | rest.conversations.read |
| GET | /api/v1/conversations/{id} | rest.conversations.read |
| PATCH | /api/v1/conversations/{id} | rest.conversations.write |
| GET | /api/v1/conversations/{id}/messages | rest.conversations.messages.read |
| POST | /api/v1/conversations/{id}/messages | rest.conversations.write |
| POST | /api/v1/conversations/{id}/media | rest.conversations.write |
| GET | /api/v1/conversations/{id}/notes | rest.conversations.read |
| POST | /api/v1/conversations/{id}/notes | rest.conversations.write |
| GET | /api/v1/conversation-tags | rest.conversations.read |
| POST | /api/v1/conversations/{id}/tags | rest.conversations.write |
| DELETE | /api/v1/conversations/{id}/tags/{tag_id} | rest.conversations.write |
| GET | /api/v1/conversations/{id}/participants | rest.conversations.read |
| POST | /api/v1/conversations/{id}/participants | rest.conversations.write |
| DELETE | /api/v1/conversations/{id}/participants/{participant_id} | rest.conversations.write |
Lista con q, status (open / pending / closed / snoozed) y contact_id. PATCH status es open, closed o snoozed — pending queda como filtro. snoozed_until es obligatorio con status snoozed y debe ser futuro. Ya-snoozed rechaza un nuevo snooze: abre primero. priority: low | normal | high | urgent. Reply es texto; DNC, hilo cerrado y canal inactivo fallan cerrados. Las notas internas son staff-only, 1–5000 chars, distintas de /api/v1/notes. Las tags del inbox son otro catálogo (GET /conversation-tags), máximo 10. Participantes staff: observer | collaborator; collaborator en canal exclusivo es 403.
Query
| Parámetro | Tipo | Notas |
|---|---|---|
| q | string | Busca el hilo. |
| status | open | pending | closed | snoozed | Filtro. pending no es PATCH. |
| contact_id | UUID | Hilos de ese contacto. |
| limit / cursor | number / string | Página de cursor. limit 1–100. |
Campos
| Campo | Tipo | Notas |
|---|---|---|
| id / display_id | UUID / string | Identidad pública del hilo. |
| status | string | open, pending, closed, snoozed. |
| can_reply | boolean | WhatsApp false = ventana 24h cerrada. |
| owner_id | UUID | null | Miembro. Unassign exclusivo falla cerrado. |
| priority | low | normal | high | urgent | PATCH. |
| content | string | Reply texto. 201 { id, status: pending }. |