Quién puede usarlo
URL base de la API
Esta tarjeta muestra la dirección de la API REST. En tu integración, usahttps://api.flowella.io/v1 como URL base, aunque la tarjeta muestre una dirección que termine en /api/v1. Consulta 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.
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.
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 conGET /v1/sandbox y PATCH /v1/sandbox, usando el cuerpo { "enabled": true } o { "enabled": false }. Ambos necesitan el scope sandbox:manage.
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 solo cubre las solicitudes hechas con esa clave.Qué cambia en el sandbox
Cuando el sandbox cubre una solicitud:POST /v1/messagesguarda el mensaje en la conversación y devuelve"sandbox": trueconmetaMessageIdestablecido ennull. Nada llega a WhatsApp y no se activa ningún webhookmessage.sent.- El envío de plantillas con
POST /v1/templates/{id}/submitno llega a Meta. Aprueba la plantilla al instante, o la rechaza si el nombre de la plantilla contienereject_. Un encabezado multimedia cuya muestra es solo una dirección web se rechaza con400 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 scopesandbox:manage y funcionan tanto si el sandbox está activado como si no, así que úsalos solo con datos de prueba.
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.Enlaces
Relacionado
Introducción a la API
Autenticación, scopes, límites de velocidad y errores.
Claves de API
Crea claves reales y claves sandbox.
Aplicaciones de desarrollador
Registra una aplicación OAuth y gestiona las aplicaciones instaladas.
Referencia de webhooks
Tipos de eventos, payloads y comprobación de firmas.