Responder en una conversación

POST 
/inbox/conversations/:id/messages

Envía un mensaje por el número de la conversación, elegido por kind:

kind	Qué
text	Texto libre. Solo con la ventana de 24 horas abierta
media	Un archivo ya subido en POST /inbox/conversations/{id}/media. Solo con la ventana abierta
template	Una plantilla aprobada. Reabre la conversación en cualquier momento
note	Nota interna: queda en la conversación, nunca va a WhatsApp

Fuera de la ventana, text y media se rechazan antes del envío con 422 window_closed y el windowExpiresAt. La respuesta reabre una conversación cerrada o pospuesta y pausa las automatizaciones por un tiempo, como cuando responde alguien del equipo.

Request

Responses

201

Mensaje registrado.

401

Token ausente, mal formado, desconocido o revocado (authentication), o cuenta suspendida (tenant_inactive).

402

Sin derecho de uso (payment_required). El cuerpo trae el motivo en reason y la salida en action: qué hacer (kind) y la página del panel donde se hace (url).

404

El recurso no existe (not_found).

409

El número de la conversación ya no está conectado (phone_unavailable).

422

window_closed, contact_unreachable, media_not_found, template_unavailable, template_variables_invalid, contact_opted_out (plantilla de marketing), meta_error o invalid_request.

429

Límite de peticiones superado (rate_limit).

Response Headers

Retry-After

Segundos a esperar antes de reintentar.

X-RateLimit-Category

Categoría de límite aplicada — send, media o default.

X-RateLimit-Scope

Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).

X-RateLimit-Limit

Techo de peticiones de la categoría en la ventana actual.

X-RateLimit-Remaining

Peticiones restantes en la ventana actual.