> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Developer hub: sandbox de la API, solicitudes recientes y documentación de la API > Consulta tus solicitudes recientes a la API de Flowella, activa o desactiva el sandbox de la API para toda la organización y abre guías de inicio rápido, documentación interactiva de la API, Postman y OpenAPI. El Developer hub reúne todo lo que necesitas para desarrollar sobre la [API REST de Flowella](https://knowledge.flowella.io/es/api-reference/introduction.md). Muestra la dirección de la API, un registro de las solicitudes recientes a la API, el interruptor **API sandbox** para toda la organización, guías de inicio rápido y enlaces a la documentación de la API. Para abrirlo, ve a **Settings** y selecciona **Developer hub** en el grupo **Developer**. ## Quién puede usarlo | Parte del hub | Quién puede usarla | | - | - | | **API base URL**, **Quickstarts** y **Links** | Todas las personas de la organización. | | **Recent API requests** | Owners y Admins. Para los demás roles, la tarjeta no muestra ninguna solicitud. | | **API sandbox** | Todos pueden ver si está **Active** u **Off**. Solo los Owners y Admins pueden activarlo o desactivarlo. | | Las claves de API y las aplicaciones de desarrollador que abren los enlaces | Owners y Admins. Consulta [Claves de API](https://knowledge.flowella.io/es/settings/api-keys.md) y [Aplicaciones de desarrollador](https://knowledge.flowella.io/es/settings/developer-apps.md). | ## URL base de la API Esta tarjeta muestra la dirección de la API REST. En tu integración, usa `https://api.flowella.io/v1` como URL base, aunque la tarjeta muestre una dirección que termine en `/api/v1`. Consulta [URL base](https://knowledge.flowella.io/es/api-reference/introduction.md#url-base) para saber por qué. ## Solicitudes de API recientes Esta tarjeta enumera las 25 solicitudes a la API más recientes hechas a tu organización con claves de API o tokens de acceso OAuth, empezando por la más reciente. | Columna | Qué muestra | | - | - | | **Time** | Cuándo recibió Flowella la solicitud. | | **Method** | El método HTTP, por ejemplo `POST`. | | **Path** | El endpoint al que se llamó. | | **Status** | El estado HTTP que devolvió Flowella. | | **Actor** | Quién hizo la llamada: `key:` seguido de un identificador para una clave de API, u `oauth:` seguido del client ID de una aplicación OAuth. El identificador `key:` no es el prefijo de clave que se muestra en la pantalla API keys. | | **Request id** | El ID de la solicitud, el mismo valor que la cabecera de respuesta `X-Request-Id`. | Las solicitudes que Flowella rechaza antes de ejecutarlas no aparecen. Entre ellas están las solicitudes con un token ausente o no válido, sin el scope necesario, con una cabecera `API-Version` no admitida o que superan el límite de velocidad. Para ver todo lo relacionado con una solicitud, como los eventos, los trabajos y las entregas de webhooks que provocó, llama a `GET /v1/requests/{requestId}` con el **Request id**. Necesita el scope `account:read`. Consulta [IDs de solicitud](https://knowledge.flowella.io/es/api-reference/introduction.md#ids-de-solicitud). ## Sandbox de la API La tarjeta **API sandbox** tiene un interruptor para toda la organización que permite hacer pruebas sin enviar nada a WhatsApp. La insignia muestra **Active** cuando el sandbox está activado y **Off** cuando está desactivado. **Sandbox guide** abre la guía del sandbox en la aplicación. Para activar el sandbox, un Owner o Admin marca la casilla de la parte inferior de la tarjeta. Desmárcala para desactivarlo. El cambio se aplica al instante a toda la organización. También puedes consultar y cambiar el ajuste con `GET /v1/sandbox` y `PATCH /v1/sandbox`, usando el cuerpo `{ "enabled": true }` o `{ "enabled": false }`. Ambos necesitan el scope `sandbox:manage`. > [!WARNING] > > El sandbox de la API afecta a algo más que las llamadas a la API. Mientras está activado, [Bulk send](https://knowledge.flowella.io/es/app/bulk-send.md) en la aplicación y la acción **Send WhatsApp Template** de los workflows de HubSpot también dejan de llegar a los contactos. Las respuestas desde el Inbox y las acciones de HubSpot **Send WhatsApp Message** y **Send WhatsApp Reply** se siguen enviando de verdad. Desactiva el sandbox en cuanto termines de hacer pruebas. ### Sandbox de la API y claves sandbox Hay dos formas de usar el sandbox. El **API sandbox** de toda la organización cubre todas las solicitudes, mientras que una [clave sandbox](https://knowledge.flowella.io/es/settings/api-keys.md#claves-sandbox) solo cubre las solicitudes hechas con esa clave. | | **API sandbox** de toda la organización | **Sandbox key** | | - | - | - | | Cómo se activa | Un Owner o Admin marca el interruptor aquí o llama a `PATCH /v1/sandbox`. | Marca **Sandbox key** al crear una clave de API. | | Qué solicitudes cubre | Todas las solicitudes a la API de la organización, desde cualquier clave de API o aplicación OAuth. | Solo las solicitudes hechas con esa clave. | | `POST /v1/messages` | Se guarda en Flowella, no se envía. | Se guarda en Flowella, no se envía. | | Envío de plantillas para revisión | Decisión simulada instantánea. | Decisión simulada instantánea. | | Envíos de prueba de plantillas | Se omiten. | Se omiten. | | `POST /v1/templates/send` | Los destinatarios se registran como completados y no se envía nada. | Se envía de verdad. | | **Bulk send** en la aplicación y la acción **Send WhatsApp Template** de HubSpot | Los destinatarios se registran como completados y no se envía nada. | No le afecta. | ### Qué cambia en el sandbox Cuando el sandbox cubre una solicitud: * `POST /v1/messages` guarda el mensaje en la conversación y devuelve `"sandbox": true` con `metaMessageId` establecido en `null`. Nada llega a WhatsApp y no se activa ningún webhook `message.sent`. * El envío de plantillas con `POST /v1/templates/{id}/submit` no llega a Meta. Aprueba la plantilla al instante, o la rechaza si el nombre de la plantilla contiene `reject_`. Un encabezado multimedia cuya muestra es solo una dirección web se rechaza con `400 INVALID_TEMPLATE_COMPONENTS`. La decisión aparece en la API y en el feed de eventos, pero la página **Templates** de la aplicación no cambia. * El sandbox se ejecuta en tu organización real. Los contactos, las conversaciones y los mensajes creados durante las pruebas se guardan como cualquier otro y aparecen en la aplicación. ### Herramientas de prueba del sandbox Estos endpoints te ayudan a simular actividad. Necesitan el scope `sandbox:manage` y funcionan tanto si el sandbox está activado como si no, así que úsalos solo con datos de prueba. | Método | Ruta | Qué hace | | - | - | - | | `GET` | `/v1/sandbox/status` | Indica si el sandbox de la API está activado, y `sandboxKey`, que indica si tu clave es una clave sandbox. | | `POST` | `/v1/test/contacts` | Crea o actualiza un contacto a partir de `phone` y, opcionalmente, `name` y `email`. | | `POST` | `/v1/test/messages/{id}/simulate-status` | Añade al feed de eventos un evento `message.sent`, `message.delivered`, `message.read`, `message.failed` o `message.accepted` para un mensaje. Envía el `status` sin el prefijo `message.`. | | `POST` | `/v1/test/webhooks/replay-event` | Añade al feed de eventos un evento del `type` que elijas. | | `POST` | `/v1/sandbox/fixtures/reset` | Borra los eventos del sandbox, los trabajos del sandbox y las decisiones simuladas de plantillas. `POST /v1/test/reset` hace lo mismo. | Las herramientas de prueba solo escriben en el feed de eventos (`GET /v1/events`). No envían webhooks ni modifican el mensaje en sí. ## Guías de inicio rápido La tarjeta **Quickstarts** enlaza a guías paso a paso. Cada una se abre como archivo Markdown en una pestaña nueva. | Guía de inicio rápido | Qué cubre | | - | - | | Salesforce | Instalación con OAuth, envío de plantillas e ingesta de formularios. | | Zoho CRM | Upsert masivo de contactos y webhooks salientes. | | SurveyMonkey | Asignación de datos de encuestas y webhooks entrantes. | | Typeform | Flujos del proveedor Typeform y webhooks entrantes. | | n8n | Nodos HTTP Request que llaman a la API. | ## Enlaces | Enlace | Qué abre | | - | - | | **Interactive API docs** | La referencia de la API en la aplicación, con esquemas de solicitud y ejemplos para probar. Pega una clave de API para enviar solicitudes de prueba. | | **Manage API keys** | [Claves de API](https://knowledge.flowella.io/es/settings/api-keys.md), donde creas y revocas claves. | | **Developer apps** | [Aplicaciones de desarrollador](https://knowledge.flowella.io/es/settings/developer-apps.md), donde registras aplicaciones OAuth. | | **OpenAPI JSON** | El documento OpenAPI de la API, que puedes importar en Postman, Insomnia o un generador de código. | | **Postman collection** | Descarga `flowella-v1.postman_collection.json`. | | **Capabilities matrix (authenticated)** | `GET /v1/capabilities`, que muestra los scopes de tu token, si el sandbox está activado y los tipos de mensaje y categorías de plantilla admitidos. Necesita una clave de API con el scope `account:read`, así que una pestaña del navegador muestra un error de autenticación. Llámalo desde tu cliente de API. | ## Relacionado > **[Introducción a la API](https://knowledge.flowella.io/es/api-reference/introduction.md)** > > Autenticación, scopes, límites de velocidad y errores. > **[Claves de API](https://knowledge.flowella.io/es/settings/api-keys.md)** > > Crea claves reales y claves sandbox. > **[Aplicaciones de desarrollador](https://knowledge.flowella.io/es/settings/developer-apps.md)** > > Registra una aplicación OAuth y gestiona las aplicaciones instaladas. > **[Referencia de webhooks](https://knowledge.flowella.io/es/api-reference/webhooks.md)** > > Tipos de eventos, payloads y comprobación de firmas. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.