API: cómo listar y enviar mensajes en salas de chat

Consultar el historial paginado y enviar mensajes autorizados.

Requisitos previos

• Token de API.
• ID de cuenta y sala.
• Membresía o permiso compatible.

Permisos y disponibilidad

La interfaz utilizada para esta documentación fue observada con un usuario Administrador. La creación y administración de salas puede requerir permisos. El acceso a canales privados, mensajes directos, hilos, archivos y llamadas depende de la membresía, las funciones habilitadas y el estado de disponibilidad de los participantes.

Ruta de acceso

API de Waclis Inbox > Salas de chat > Mensajes

Procedimiento

1. Ejecuta GET sobre la colección de mensajes.
2. Añade page y per_page para paginar.
3. Consulta los encabezados de paginación.
4. Envía un mensaje con POST.
5. Comprueba remitente, contenido, adjuntos y estado.

Campos y opciones

| Elemento | Descripción | |---|---| | GET | /api/v1/accounts/:account_id/chat_rooms/:chat_room_id/messages | | POST | Misma ruta para crear un mensaje. | | X-Total-Count | Cantidad total. | | X-Current-Page | Página actual. | | X-Per-Page | Elementos por página. | | X-Total-Pages | Páginas totales. |

Ejemplos

Listar página

curl -X GET \
  '{{base_url}}/api/v1/accounts/{{account_id}}/chat_rooms/{{room_id}}/messages?page=2&per_page=50' \
  -H 'api_access_token: {{token}}'

Enviar texto

{
  "chat_room_message": {
    "content": "Mensaje interno de prueba"
  }
}

Resultado esperado

Puedes interpretar o ejecutar la operación con el alcance y las comprobaciones adecuadas.

Artículos relacionados

• Cómo enviar mensajes y archivos en una sala
• Cómo responder en un hilo
• Referencia general de la API de salas de chat