Mensajes directos en todas las redes, desde tu propio código
FoPost reúne en un solo lugar cada hilo de DM de tus cuentas conectadas. Lista conversaciones, inicia nuevas, escribe a un segmento de tus contactos de una vez o envía una serie de mensajes a lo largo de varios días, todo con la misma clave de API.
curl "https://api.fopost.com/v1/inbox/conversations?workspace_id=9b2f6c1e-..." \
-H "X-API-Key: $API_KEY"
{
"data": [
{
"workspace_id": "9b2f6c1e-...",
"account_id": "4a71d80b-...",
"conversation_id": "t_1029384756",
"message_count": 6,
"unread_count": 2,
"last_message_at": "2026-11-10T16:42:08Z",
"last_message_text": "Is the large size back in stock?",
"last_message_outbound": false,
"participant": { "name": "Jordan P.", "handle": "jordanp", "avatar_url": "https://..." },
"account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }
}
],
"meta": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 }
}Una sola lista de hilos
Todas las conversaciones de DM de todas las cuentas conectadas, las más recientes primero.
Difusiones
Un mensaje en los hilos existentes de un conjunto filtrado de contactos.
Secuencias
Una serie de mensajes, cada uno enviado un número fijo de horas después del anterior.
Lee un hilo, respóndelo o abre uno nuevo
Responde dentro de un hilo existente con POST /v1/inbox/:id/reply. Inicia una conversación nueva por nombre de usuario en X, Mastodon, Reddit y Slack, o pasa comment_id para responder en privado a un comentario de Instagram o Facebook. En Facebook e Instagram también puedes mostrar un indicador de escritura, y en Messenger pasar un hilo a otra app y recuperarlo.
Lee la referencia de conversacionescurl -X POST https://api.fopost.com/v1/inbox/conversations \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "4a71d80b-...",
"handle": "jordanp",
"text": "Thanks for the order. Your tracking link is on its way."
}'
{ "conversation_id": "t_1029384756", "item": { "id": "2c9d4e81-...", "type": "dm", ... } }Texto y multimedia
Hasta 10 ids de medios de tu biblioteca se adjuntan donde la red lo permite.
Escritura y traspaso
POST /v1/inbox/conversations/:id/typing y /handover para conversaciones de Meta.
X Chat
Las conversaciones cifradas de X pasan como texto cifrado; la clave se queda en el navegador.
Escribe a un segmento sin romper las reglas de la plataforma
Una difusión entra en las conversaciones que tu cuenta ya tiene con un conjunto de contactos, filtrado por red, etiqueta, origen o campo personalizado. Facebook, Instagram y WhatsApp solo permiten un mensaje de empresa dentro de las 24 horas posteriores al último mensaje del contacto, así que los destinatarios fuera de esa ventana se omiten con un motivo, nunca se intenta el envío. En WhatsApp, una plantilla aprobada puede ir más allá.
Consulta la referencia de difusionescurl -X POST https://api.fopost.com/v1/broadcasts \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "9b2f6c1e-...",
"account_id": "4a71d80b-...",
"name": "Restock, November",
"text": "The large size is back in stock this week.",
"audience": { "platforms": ["instagram"], "label_ids": ["d41e7a90-..."] }
}'
curl -X POST https://api.fopost.com/v1/broadcasts/8e2a5c13-.../send -H "X-API-Key: $API_KEY"
{ "id": "8e2a5c13-...", "status": "sending", "recipients": 212 }Envía ahora o después
Define scheduled_at para ponerlo en cola, o cancélalo antes de que salga.
Resultado por destinatario
GET /v1/broadcasts/:id/recipients muestra enviado, omitido o fallido, y por qué.
Enviado una sola vez
Cada destinatario se reserva antes de enviar, así que un reintento nunca escribe dos veces.
Haz seguimiento durante días, de forma automática
Una secuencia es una lista de hasta 20 pasos, cada uno con un mensaje y un retraso en horas respecto al anterior. Inscribe contactos por id o con el mismo filtro de audiencia que usa una difusión, y cancela su inscripción cuando quieras. Un paso que cae fuera de la ventana de mensajería se omite y la secuencia continúa.
Consulta la referencia de secuenciascurl -X POST https://api.fopost.com/v1/sequences/5b9c2e40-.../enroll \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "contact_ids": ["a7f3c2d1-..."] }'
{ "id": "5b9c2e40-...", "enrolled": 1 }Pausa cuando quieras
Establece status en paused y no sale ningún paso más hasta que la reanudes.
Cancelar inscripción
POST /v1/sequences/:id/unenroll detiene a un contacto de inmediato.
Recuentos de inscripción
Activas, completadas, detenidas y fallidas, por secuencia.
Sabe con quién estás hablando
Las personas que escriben a tus cuentas se convierten en contactos automáticamente. Añade más a mano o importa un CSV de hasta 5.000 filas con una columna de plataforma y otra de nombre de usuario. Define hasta 50 campos personalizados por espacio de trabajo (texto, número, fecha, selección o sí/no) y filtra difusiones y secuencias con ellos.
Empieza a construir
Importación CSV
POST /v1/contacts/import devuelve las filas creadas, combinadas y omitidas, con sus motivos.
Campos personalizados
Las columnas que coinciden con la clave de un campo se rellenan al importar.
Historial completo
GET /v1/contacts/:id/conversations lista lo que escribió cada contacto.
Preguntas sobre API de mensajería, respondidas
¿A qué redes puedo escribir?
¿Qué es la ventana de mensajería?
¿Qué permisos de clave de API necesito?
¿Puede una difusión escribir a personas que nunca nos han escrito?
¿Se envía algo sin que yo lo pida?
¿Hay un límite de solicitudes?
Empieza hoy a construir con la API de mensajería
Empezar es gratis y la API completa está incluida. Crea una clave y haz tu primera llamada en minutos.
Obtén tu clave de API