# Consultar el envío a TikTok

> Consulta la misma operación sin volver a enviar. inbox_delivered significa notificación entregada, no publicado.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **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-Connection` en REST y campo `connectionId` en el `execute` de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](/docs/referencia/conexiones/estado-consultar).

## Qué hace [#qué-hace]

Sólo published acredita que la persona completó la publicación en TikTok; los identificadores públicos pueden faltar.

## Entrada [#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)$\` | sí |   |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
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"}}'
```

```json title="MCP · meta-tool execute"
{
  "tool": "tiktok.inbox.verificar",
  "params": {
    "idempotencyKey": "00000000-0000-4000-8000-000000000001"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "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 [#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í        |             |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Errores de esta tool [#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](/docs/referencia/errores).


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/tiktok/inbox-verificar.
