Instagram: cuentas, comentarios y DM

Con los alcances de Instagram, la API lista las cuentas conectadas al workspace, responde y oculta comentarios y envía DM, desde las mismas cuentas que usas en XBASE.

Listar las cuentasCopy Anchor Link

GET https://api.xbase.app/api/external/v1/instagram/accounts

Alcance instagram:read. Respuesta 200:

[
  {
    "connectionId": "6d1f…",
    "instagramAccountId": "17841400000000000",
    "username": "miempresa",
    "name": "Mi Empresa",
    "profilePictureUrl": "https://…",
    "messagingAccess": true,
    "missingScopes": []
  }
]

Solo aparecen las cuentas activas.

Responder un comentarioCopy Anchor Link

POST https://api.xbase.app/api/external/v1/instagram/comments/{commentId}/reply

Alcance instagram:act. Cuerpo: { "connectionId": "…", "message": "¡Gracias!" }, con message de hasta 2.200 caracteres. La respuesta es pública, debajo del comentario. Respuesta: { "id": "…" }, el id de la respuesta en Instagram.

Responder por DM (respuesta privada)Copy Anchor Link

POST https://api.xbase.app/api/external/v1/instagram/comments/{commentId}/private-reply

Alcance instagram:act. El mismo cuerpo del punto anterior. Envía un DM al autor del comentario. Respuesta: { "messageId": "…" }.

Meta acepta una respuesta privada por comentario, en hasta 7 días. La segunda responde 422 META_ERROR.

Ocultar un comentarioCopy Anchor Link

POST https://api.xbase.app/api/external/v1/instagram/comments/{commentId}/hide

Alcance instagram:act. Cuerpo: { "connectionId": "…", "hidden": true } (false lo vuelve a mostrar). Respuesta: { "success": true }.

Enviar un DMCopy Anchor Link

POST https://api.xbase.app/api/external/v1/instagram/messages

Alcance instagram:act. Cuerpo: { "connectionId": "…", "recipientId": "…", "text": "¡Hola!" }, con text de hasta 1.000 caracteres. recipientId es el id de la persona en Instagram, que viene en los eventos del webhook. Respuesta: { "messageId": "…" }.

Meta solo acepta DM dentro de la ventana de 24 horas desde el último mensaje de la persona. Fuera de ella, la respuesta es 422 META_ERROR.

Errores de InstagramCopy Anchor Link

Preguntas frecuentesCopy Anchor Link

Ver tambiénCopy Anchor Link