Eventos de la bandeja en tiempo real
GET/inbox/stream
Un stream Server-Sent Events con lo que pasa en la bandeja: mensaje nuevo, estado de mensaje, conversación actualizada, alguien escribiendo. Los eventos avisan qué cambió, sin el contenido — busca la conversación o los mensajes después.
El stream empieza con event: ready y envía un comentario : ping cada 25 segundos.
No hay reenvío: el id de cada evento es un contador de la conexión, y
Last-Event-ID no recupera nada. En cada (re)conexión, vuelve a leer lo que importa. El
EventSource del navegador no envía la cabecera Authorization — usa un cliente que la
envíe. Como máximo 5 streams abiertos por API key.
Responses
- 200
- 401
- 402
- 429
Stream text/event-stream. Eventos: message.created, message.updated, conversation.updated y typing, cada uno con conversationId y phoneNumberId en data.
Token ausente, mal formado, desconocido o revocado (authentication), o cuenta
suspendida (tenant_inactive).
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).
Demasiados streams abiertos para esta credencial (too_many_streams).