# Enviar el video aprobado a TikTok

> Envía una sola vez el video aprobado mediante la misma sesión humana para que la persona abra su notificación en TikTok y complete la publicación.



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

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID**         | `tiktok.inbox.enviar`                                             |
| **Nombre MCP**      | `tiktok__inbox__enviar`                                           |
| **Conector**        | `tiktok`                                                          |
| **Plano**           | `action`                                                          |
| **Scope (permiso)** | `tiktok:upload`                                                   |
| **Auth**            | `connection_credentials`                                          |
| **Versión**         | `1`                                                               |
| **Sensible**        | sí                                                                |
| **Deprecado**       | no                                                                |
| **Comportamiento**  | readOnly=false, destructive=true, 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_write` 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]

No publica automáticamente. Exige Idempotency-Key UUID v4 igual a la aprobación. Ante resultado incierto sólo consulta la misma operación.

## Entrada [#entrada]

| Campo        | Tipo   | Requerido | Descripción |
| ------------ | ------ | --------- | ----------- |
| `approvalId` | string | sí        |             |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "approvalId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 240
      }
    },
    "required": [
      "approvalId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/tiktok.inbox.enviar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Idempotency-Key: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \
  -H "Content-Type: application/json" \
  -d '{"input":{"approvalId":"aprobacion_ejemplo"}}'
```

```json title="MCP · meta-tool execute_write"
{
  "tool": "tiktok.inbox.enviar",
  "params": {
    "approvalId": "aprobacion_ejemplo"
  },
  "connectionId": "conn_9tKfR2mQx4Vb",
  "idempotencyKey": "9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743"
}
```

> **Clave de idempotencia obligatoria.** Sin ella la llamada responde `idempotency_key_missing`. Genera un UUID v4 nuevo por operación y envíalo en `Idempotency-Key` (REST) o en `idempotencyKey` (MCP). Repite la misma clave solo al reintentar esa operación.

**Salida esperada (200):**

```json
{
  "data": {
    "operationId": "operacion_ejemplo",
    "state": "processing",
    "publicPostIds": [],
    "retryAutomatically": false
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "tiktok.inbox.enviar",
    "plane": "action",
    "latency_ms": 7410,
    "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.                                                                      |
| `connection_credential_required` | 428  | no           | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
| `connection_busy`                | 409  | sí           | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.                                                          |
| `upstream_error`                 | 502  | sí           | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.                                                                                          |
| `timeout`                        | 504  | sí           | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.                                                                                           |
| `connector_onboarding_required`  | 428  | no           | Lee el mensaje: dice qué falta. Se completa en el portal de ese sistema, no en Emisso, y después la llamada funciona sin cambios.                                                        |
| `connection_scope_not_enabled`   | 403  | no           | Pide a un owner/admin que habilite el scope en /connections para esa conexión, o usa otra que ya lo tenga activo. Cambiar la credencial del actor no resuelve este error.                |
| `rate_limited`                   | 429  | sí           | Espera y reintenta con backoff exponencial.                                                                                                                                              |
| `upstream_unexpected_response`   | 502  | no           | No reintentes: la respuesta es determinista. Repórtalo con el request\_id para que actualicemos el conector.                                                                             |
| `idempotency_key_missing`        | 400  | no           | Genera un UUID v4, envíalo como Idempotency-Key y reutilízalo solo para reintentos de esta misma operación.                                                                              |
| `idempotency_in_progress`        | 409  | sí           | Espera unos segundos y reintenta con la MISMA clave. Generar una nueva para la misma operación es lo que duplica el efecto.                                                              |
| `idempotency_conflict`           | 409  | no           | Genera una clave nueva para una operación nueva; reutiliza la clave solo para reintentar la misma.                                                                                       |

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-enviar.
