API de comentarios y bandeja de entradaAPI

Todos los comentarios y mensajes, en una cola que puedes programar

FoPost reúne los comentarios y mensajes directos de cada cuenta conectada en una sola bandeja de entrada. Lístalos, cuenta los no leídos, marca elementos como gestionados y responde, todo con la misma API que usa tu panel.

Consigue tu clave de APILee la documentación
GET /v1/inbox
curl "https://api.fopost.com/v1/inbox?workspace_id=9b2f6c1e-...&state=unread" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "1f8b6a37-...", "type": "comment", "state": "unread", "platform": "instagram", "author_name": "Customer", "author_handle": "customer", "text": "Does this ship to Canada?", "post": { "id": "7d3e0a52-...", "title": "Launch day" }, "platform_created_at": "2026-08-29T14:02:11Z", "can_reply": true, "account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }, "workspace_id": "9b2f6c1e-..." },
    { "id": "2c9d4e81-...", "type": "dm", "state": "unread", "platform": "facebook", "author_name": "Jordan P.", "author_handle": null, "text": "Hi, I need help with an order.", "post": null, "platform_created_at": "2026-08-29T13:48:30Z", "can_reply": true, "account": { "id": "c30e9f12-...", "platform": "facebook", "username": "yourbrand" }, "workspace_id": "9b2f6c1e-..." }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 2, "total_pages": 1 }
}

Una lista

Comentarios y mensajes de todas las cuentas, los más nuevos primero, con los mismos campos.

Recuento de no leídos

Una sola llamada para el número de la insignia, por espacio de trabajo o en todos.

Responde desde el código

Responde a un comentario o mensaje y la respuesta vuelve a la red.

Leer

Dirige las conversaciones entrantes al lugar correcto

Consulta la bandeja de entrada de forma programada o cuando quieras, filtra por tipo, cuenta o estado, y reenvía cada elemento a tu servicio de asistencia, a tu canal de chat o a una persona. Cada elemento enlaza con su publicación, cuando la tiene.

Leer la referencia de la bandeja de entrada
GET /v1/inbox/unread-count
curl "https://api.fopost.com/v1/inbox/unread-count?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

{ "count": 14 }

Filtrar

Por tipo, cuenta, plataforma o estado de lectura, con paginación.

Enlazado a la publicación

Los comentarios indican a qué publicación pertenecen, para que los cruces con las analíticas.

Cuentas de la bandeja de entrada

GET /v1/inbox/accounts lista qué cuentas conectadas alimentan la bandeja de entrada.

Responder

Responde donde el cliente preguntó

Envía por POST una respuesta a un elemento de la bandeja y se publica como respuesta a un comentario o mensaje directo en la red de origen, desde la cuenta conectada. Marca los elementos como read, resolved o snoozed con PATCH para que dos sistemas nunca gestionen el mismo.

Ver el endpoint de respuesta
POST /v1/inbox/:id/reply
curl -X POST https://api.fopost.com/v1/inbox/1f8b6a37-.../reply \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Yes, we ship to Canada. Delivery takes 3 to 5 days." }'

curl -X PATCH https://api.fopost.com/v1/inbox/1f8b6a37-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "state": "read" }'

Respuesta nativa

Las respuestas a comentarios y los mensajes directos salen por la propia API de la red.

Actualizaciones de estado

read, resolved o snoozed, para que los elementos gestionados salgan de la cola.

Envíos explícitos

Nada responde por sí solo. Cada mensaje saliente es una solicitud que haces tú.

Sincronización

Al día cuando lo necesitas, en silencio cuando no

La bandeja de entrada se sincroniza de forma programada en cada cuenta conectada. Cuando necesites lo último en ese momento, llama al endpoint de actualización del espacio de trabajo y vuelve a leer. Al estar limitada al espacio de trabajo, la clave de una agencia solo ve las conversaciones de su propio cliente.

Empieza a construir
Cuentas conectadas de todas las redes en un solo espacio de trabajo

Actualización bajo demanda

POST /v1/inbox/refresh trae lo último de todas las cuentas del espacio de trabajo.

Sincronización programada

La sincronización en segundo plano mantiene la lista al día sin que hagas ninguna llamada.

Aislado por espacio de trabajo

La identidad del autor y el texto de los mensajes nunca salen de su espacio de trabajo.

Preguntas sobre API de comentarios y bandeja de entrada, respondidas

¿Qué redes alimentan la bandeja de entrada?

Cualquier cuenta conectada de una red que exponga comentarios o mensajes a través de su API. GET /v1/inbox/accounts te dice exactamente cuáles de tus cuentas están incluidas.

¿Puedo responder a mensajes directos?

Sí, cuando la red lo permite y la cuenta ha concedido el permiso de mensajería. Si una red no lo permite, el endpoint de respuesta devuelve un error que indica el motivo.

¿Con qué rapidez aparecen los comentarios nuevos?

La sincronización en segundo plano se ejecuta de forma programada por cuenta. Llama al endpoint de actualización antes de leer cuando necesites lo más nuevo en ese momento.

¿Puede la API responder automáticamente?

No. La API nunca envía una respuesta sin una solicitud tuya. Si creas respuestas automáticas, la decisión de enviar está en tu código.

¿Recibo el perfil del autor?

Recibes el nombre visible y el usuario tal como los expone la red, además de un enlace al elemento original. Los datos se quedan dentro del espacio de trabajo al que pertenece la cuenta.

¿Hay un límite de frecuencia?

Sí, 100 solicitudes por minuto por clave. Usa el recuento de no leídos para sondear y pide la lista completa solo cuando cambie.

Empieza hoy a construir con la API de comentarios y bandeja de entrada

Empezar es gratis y la API completa está incluida. Crea una clave y haz tu primera llamada en minutos.

Consigue tu clave de API