Bandeja

Mensajes directos, comentarios y reseñas de las cuentas de un perfil. Los listados piden el perfil; las acciones, la cuenta a la que pertenece cada elemento.

Listar conversaciones

GET/v1/inbox/conversationsPronto: aún no se ofrece

Mensajes directos de Facebook, Instagram, X, Bluesky, Reddit y Telegram, los más recientes primero.

Parámetros

profileIdstringobligatorio
accountIdstring
statusstring
Valores: active · archived
cursorstring
El nextCursor de la página anterior.
máx. 4000
limitinteger
máx. 100

Respuesta 200

data

itemsobject[]obligatorio
items
- idstringobligatorio
  Id opaco de la conversación.
- accountIdstringobligatorio
- platformstringobligatorio
- participantobjectobligatorio
  participant
  - namestring
  - usernamestring
  - picturestring (uri)
- lastMessagestring
- updatedAtstring (date-time)
- statusstringobligatorio
  Valores: active · archived
- unreadCountintegerobligatorio
  máx. 9.007.199.254.740.991
- urlstring (uri)
  Abre la conversación en la red.
nextCursorstring | nullobligatorio
Envíalo como cursor para la página siguiente; null en la última.

curl "https://api.usecrier.com/v1/inbox/conversations" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/conversations', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/inbox/conversations",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Listar los mensajes de una conversación

GET/v1/inbox/conversations/{id}/messagesPronto: aún no se ofrece

Parámetros

idstringobligatorio
accountIdstringobligatorio
La cuenta a la que pertenece.
cursorstring
El nextCursor de la página anterior.
máx. 4000

Respuesta 200

data

itemsobject[]obligatorio
items
- idstringobligatorio
- directionstringobligatorio
  Valores: incoming · outgoing
- textstringobligatorio
- senderNamestring
- createdAtstring (date-time)obligatorio
- attachmentsobject[]obligatorio
  attachments
  - typestringobligatorio
    Valores: image · video · audio · file · sticker · share · other
  - urlstring (uri)
  - namestring
- deliveryStatusstring
- deletedbooleanobligatorio
nextCursorstring | nullobligatorio
Envíalo como cursor para la página siguiente; null en la última.

curl "https://api.usecrier.com/v1/inbox/conversations/cnv_…/messages" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/conversations/cnv_…/messages', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/inbox/conversations/cnv_…/messages",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Enviar un mensaje

POST/v1/inbox/conversations/{id}/messagesPronto: aún no se ofrece

Texto, un adjunto o ambos. Meta solo deja responder durante las 24 horas siguientes al último mensaje de la persona.

Parámetros

idstringobligatorio

Cuerpo

accountIdstringobligatorio
La cuenta a la que pertenece.
textstring
máx. 4000
attachmentUrlstring (uri)
Una URL https pública (por ejemplo, de POST /v1/media/upload-url).
attachmentTypestring
Valores: image · video · audio · file

Respuesta 204

Sin contenido

curl -X POST "https://api.usecrier.com/v1/inbox/conversations/cnv_…/messages" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/conversations/cnv_…/messages', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.usecrier.com/v1/inbox/conversations/cnv_…/messages",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Marcar una conversación como leída

POST/v1/inbox/conversations/{id}/readPronto: aún no se ofrece

Parámetros

idstringobligatorio

Cuerpo

accountIdstringobligatorio
La cuenta a la que pertenece.

Respuesta 204

Sin contenido

curl -X POST "https://api.usecrier.com/v1/inbox/conversations/cnv_…/read" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/conversations/cnv_…/read', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.usecrier.com/v1/inbox/conversations/cnv_…/read",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Archivar o recuperar una conversación

PATCH/v1/inbox/conversations/{id}Pronto: aún no se ofrece

Parámetros

idstringobligatorio

Cuerpo

accountIdstringobligatorio
La cuenta a la que pertenece.
statusstringobligatorio
Valores: active · archived

Respuesta 204

Sin contenido

curl -X PATCH "https://api.usecrier.com/v1/inbox/conversations/cnv_…" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/conversations/cnv_…', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.patch(
    "https://api.usecrier.com/v1/inbox/conversations/cnv_…",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Listar publicaciones con comentarios

GET/v1/inbox/posts

Publicaciones recientes de las cuentas del perfil con su número de comentarios, también las publicadas fuera de Crier.

Parámetros

profileIdstringobligatorio
accountIdstring
cursorstring
El nextCursor de la página anterior.
máx. 4000
limitinteger
máx. 100

Respuesta 200

data

itemsobject[]obligatorio
items
- idstringobligatorio
  Id opaco de la publicación para los endpoints de comentarios.
- accountIdstringobligatorio
- platformstringobligatorio
- contentstringobligatorio
- picturestring (uri)
- urlstring (uri)
- createdAtstring (date-time)
- commentCountintegerobligatorio
  máx. 9.007.199.254.740.991
- likeCountintegerobligatorio
  máx. 9.007.199.254.740.991
nextCursorstring | nullobligatorio
Envíalo como cursor para la página siguiente; null en la última.

curl "https://api.usecrier.com/v1/inbox/posts?profileId=prf_8f2k4d" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/posts?profileId=prf_8f2k4d', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/inbox/posts?profileId=prf_8f2k4d",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Listar los comentarios de una publicación

GET/v1/inbox/posts/{id}/comments

Parámetros

idstringobligatorio
accountIdstringobligatorio
La cuenta a la que pertenece.
cursorstring
El nextCursor de la página anterior.
máx. 4000

Respuesta 200

data

itemsobject[]obligatorio
items
- idstringobligatorio
  Id opaco del comentario.
- textstringobligatorio
- authorobjectobligatorio
  author
  - namestring
  - usernamestring
  - picturestring (uri)
  - isOwnerbooleanobligatorio
    Escrito por la cuenta conectada.
- createdAtstring (date-time)
- likeCountintegerobligatorio
  máx. 9.007.199.254.740.991
- replyCountintegerobligatorio
  máx. 9.007.199.254.740.991
- urlstring (uri)
- canobjectobligatorio
  Lo que esta red permite hacer con él.
  can
  - replybooleanobligatorio
  - deletebooleanobligatorio
  - hidebooleanobligatorio
  - likebooleanobligatorio
- hiddenbooleanobligatorio
- likedbooleanobligatorio
- repliesobject[]obligatorio
  replies
  - idstringobligatorio
    Id opaco del comentario.
  - textstringobligatorio
  - authorobjectobligatorio
    author
    namestring
    usernamestring
    picturestring (uri)
    isOwnerbooleanobligatorio
    Escrito por la cuenta conectada.
  - createdAtstring (date-time)
  - likeCountintegerobligatorio
    máx. 9.007.199.254.740.991
  - replyCountintegerobligatorio
    máx. 9.007.199.254.740.991
  - urlstring (uri)
  - canobjectobligatorio
    Lo que esta red permite hacer con él.
    can
    replybooleanobligatorio
    deletebooleanobligatorio
    hidebooleanobligatorio
    likebooleanobligatorio
  - hiddenbooleanobligatorio
  - likedbooleanobligatorio
nextCursorstring | nullobligatorio
Envíalo como cursor para la página siguiente; null en la última.

curl "https://api.usecrier.com/v1/inbox/posts/thr_…/comments" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/posts/thr_…/comments', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/inbox/posts/thr_…/comments",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Comentar o responder a un comentario

POST/v1/inbox/posts/{id}/comments

Parámetros

idstringobligatorio

Cuerpo

accountIdstringobligatorio
La cuenta a la que pertenece.
textstringobligatorio
máx. 8000
commentIdstring
Responder bajo este comentario; sin él, se comenta en la publicación.

Respuesta 204

Sin contenido

curl -X POST "https://api.usecrier.com/v1/inbox/posts/thr_…/comments" \
  -H "Authorization: Bearer $CRIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_3k9x2m",
    "text": "Thank you!"
  }'

const res = await fetch('https://api.usecrier.com/v1/inbox/posts/thr_…/comments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "accountId": "acc_3k9x2m",
    "text": "Thank you!"
  }),
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.usecrier.com/v1/inbox/posts/thr_…/comments",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
    json={
        "accountId": "acc_3k9x2m",
        "text": "Thank you!"
    },
)
data = res.json()["data"]

Ocultar un comentario o darle me gusta

PATCH/v1/inbox/posts/{id}/comments/{commentId}

Cada comentario indica en can lo que permite su red.

Parámetros

idstringobligatorio
commentIdstringobligatorio

Cuerpo

accountIdstringobligatorio
La cuenta a la que pertenece.
hiddenboolean
likedboolean

Respuesta 204

Sin contenido

curl -X PATCH "https://api.usecrier.com/v1/inbox/posts/thr_…/comments/cmt_…" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/posts/thr_…/comments/cmt_…', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.patch(
    "https://api.usecrier.com/v1/inbox/posts/thr_…/comments/cmt_…",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Borrar un comentario

DELETE/v1/inbox/posts/{id}/comments/{commentId}

Parámetros

idstringobligatorio
commentIdstringobligatorio
accountIdstringobligatorio
La cuenta a la que pertenece.

Respuesta 204

Sin contenido

curl -X DELETE "https://api.usecrier.com/v1/inbox/posts/thr_…/comments/cmt_…" \
  -H "Authorization: Bearer $CRIER_API_KEY"

await fetch('https://api.usecrier.com/v1/inbox/posts/thr_…/comments/cmt_…', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});

import os, requests

requests.delete(
    "https://api.usecrier.com/v1/inbox/posts/thr_…/comments/cmt_…",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)

Listar menciones

GET/v1/inbox/mentions

Publicaciones y comentarios de otros que etiquetan las cuentas del perfil, de los últimos 7 días: Instagram (cuentas conectadas con Facebook) y páginas de LinkedIn.

Parámetros

profileIdstringobligatorio
accountIdstring
cursorstring
El nextCursor de la página anterior.
máx. 4000
limitinteger
máx. 100

Respuesta 200

data

itemsobject[]obligatorio
items
- idstringobligatorio
  Id opaco de la mención.
- accountIdstringobligatorio
  La cuenta conectada que mencionaron.
- platformstringobligatorio
- kindstringobligatorio
  Instagram: etiquetada en un comentario (comment) o en el texto de una publicación (caption). LinkedIn: etiquetada en una publicación (post).
  Valores: comment · caption · post
- contentstringobligatorio
  El texto que menciona la cuenta. Instagram puede enviarlo un momento después: hasta entonces llega vacío.
- authorobjectobligatorio
  author
  - namestring
  - usernamestring
  - picturestring (uri)
- urlstring (uri)
  La publicación que menciona la cuenta (LinkedIn).
- publishedAtstring (date-time)
- canReplybooleanobligatorio
  Si se le puede responder con POST /v1/inbox/mentions/{id}/reply: solo en Instagram.
nextCursorstring | nullobligatorio
Envíalo como cursor para la página siguiente; null en la última.

curl "https://api.usecrier.com/v1/inbox/mentions?profileId=prf_8f2k4d" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/mentions?profileId=prf_8f2k4d', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/inbox/mentions?profileId=prf_8f2k4d",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Responder a una mención

POST/v1/inbox/mentions/{id}/reply

Solo Instagram (canReply): responde bajo el comentario que etiquetó a la cuenta o comenta en la publicación cuyo texto la etiquetó.

Parámetros

idstringobligatorio

Cuerpo

accountIdstringobligatorio
La cuenta a la que pertenece.
textstringobligatorio
máx. 2200

Respuesta 204

Sin contenido

curl -X POST "https://api.usecrier.com/v1/inbox/mentions/mtn_…/reply" \
  -H "Authorization: Bearer $CRIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_3k9x2m",
    "text": "Thanks for the shout-out!"
  }'

const res = await fetch('https://api.usecrier.com/v1/inbox/mentions/mtn_…/reply', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "accountId": "acc_3k9x2m",
    "text": "Thanks for the shout-out!"
  }),
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.usecrier.com/v1/inbox/mentions/mtn_…/reply",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
    json={
        "accountId": "acc_3k9x2m",
        "text": "Thanks for the shout-out!"
    },
)
data = res.json()["data"]

Listar reseñas

GET/v1/inbox/reviewsPronto: aún no se ofrece

Reseñas de Google Business y de Facebook, con su total y la valoración media.

Parámetros

profileIdstringobligatorio
accountIdstring
cursorstring
El nextCursor de la página anterior.
máx. 4000
limitinteger
máx. 100
hasReplystring
Solo reseñas con respuesta (true) o sin ella (false).
Valores: true · false

Respuesta 200

data

itemsobject[]obligatorio
items
- idstringobligatorio
  Id opaco de la reseña.
- accountIdstringobligatorio
- platformstringobligatorio
- reviewerobjectobligatorio
  reviewer
  - namestring
  - usernamestring
  - picturestring (uri)
- ratinginteger | nullobligatorio
  De 1 a 5; null en Facebook, que recomienda en su lugar.
- recommendsboolean
- textstringobligatorio
- createdAtstring (date-time)
- replyobject | nullobligatorio
  reply
  - textstringobligatorio
  - createdAtstring (date-time)
- urlstring (uri)
- locationstring
  Ficha de Google Business.
nextCursorstring | nullobligatorio
Envíalo como cursor para la página siguiente; null en la última.
summaryobjectobligatorio
summary
- totalintegerobligatorio
  máx. 9.007.199.254.740.991
- averageRatingnumber | nullobligatorio

curl "https://api.usecrier.com/v1/inbox/reviews" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/reviews', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/inbox/reviews",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Responder a una reseña

POST/v1/inbox/reviews/{id}/replyPronto: aún no se ofrece

Parámetros

idstringobligatorio

Cuerpo

accountIdstringobligatorio
La cuenta a la que pertenece.
textstringobligatorio
máx. 4000

Respuesta 204

Sin contenido

curl -X POST "https://api.usecrier.com/v1/inbox/reviews/rev_…/reply" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/inbox/reviews/rev_…/reply', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.usecrier.com/v1/inbox/reviews/rev_…/reply",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Borrar la respuesta a una reseña

DELETE/v1/inbox/reviews/{id}/replyPronto: aún no se ofrece

Solo en Google Business.

Parámetros

idstringobligatorio
accountIdstringobligatorio
La cuenta a la que pertenece.

Respuesta 204

Sin contenido

curl -X DELETE "https://api.usecrier.com/v1/inbox/reviews/rev_…/reply" \
  -H "Authorization: Bearer $CRIER_API_KEY"

await fetch('https://api.usecrier.com/v1/inbox/reviews/rev_…/reply', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});

import os, requests

requests.delete(
    "https://api.usecrier.com/v1/inbox/reviews/rev_…/reply",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)