Consultar el envío a TikTok
Consulta la misma operación sin volver a enviar. inbox_delivered significa notificación entregada, no publicado.
| Tool ID | tiktok.inbox.verificar |
| Nombre MCP | tiktok__inbox__verificar |
| Conector | tiktok |
| Plano | action |
| Scope (permiso) | tiktok:upload |
| Auth | none |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=true, destructive=false, idempotent=true, openWorld=true |
Requiere conexión. Indica cuál en cada llamada: header
X-Connect-Connectionen REST y campoconnectionIden elexecutede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.estado.consultar.
Qué hace
Sólo published acredita que la persona completó la publicación en TikTok; los identificadores públicos pueden faltar.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
idempotencyKey | string `^([0-9a-fA-F]8-[0-9a-fA-F]4-[1-8][0-9a-fA-F]3-[89abAB][0-9a-fA-F]3-[0-9a-fA-F]12 | 00000000-0000-0000-0000-000000000000 | ffffffff-ffff-ffff-ffff-ffffffffffff)$` |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"idempotencyKey": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"required": [
"idempotencyKey"
],
"additionalProperties": false
}Ejemplo
curl -X POST https://connect.emisso.ai/api/v1/tools/tiktok.inbox.verificar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input":{"idempotencyKey":"00000000-0000-4000-8000-000000000001"}}'{
"tool": "tiktok.inbox.verificar",
"params": {
"idempotencyKey": "00000000-0000-4000-8000-000000000001"
},
"connectionId": "conn_9tKfR2mQx4Vb"
}Salida esperada (200):
{
"data": {
"operationId": "operacion_ejemplo",
"state": "inbox_delivered",
"publicPostIds": [],
"retryAutomatically": false
},
"meta": {
"request_id": "req_…",
"tool_id": "tiktok.inbox.verificar",
"plane": "action",
"latency_ms": 24,
"audit_status": "recorded"
}
}Salida
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
operationId | string | sí | |
state | "processing" · "inbox_delivered" · "published" · "failed" · "unknown" | sí | |
publicPostIds | lista de string | sí | |
retryAutomatically | booleano | sí |
JSON Schema de salida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"operationId": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"state": {
"type": "string",
"enum": [
"processing",
"inbox_delivered",
"published",
"failed",
"unknown"
]
},
"publicPostIds": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
},
"retryAutomatically": {
"type": "boolean",
"const": false
}
},
"required": [
"operationId",
"state",
"publicPostIds",
"retryAutomatically"
],
"additionalProperties": false
}Errores de esta tool
| Código | HTTP | Reintentable | Qué hacer |
|---|---|---|---|
connection_disabled | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
connection_not_found | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.