Se ejecuta enWrit Cloud
En esta página
Ningún node que instalar. Tres mecanismos que ya funcionan.
Con franqueza: no existe un node de Writ para n8n, ni una app para Zapier, ni un módulo para Make. No lo busques en un directorio. Lo que sí existe son tres mecanismos genéricos que esas tres herramientas ya hablan — y cada uno se configura en cinco minutos.
encuadre ▸ qué existe
Elige la dirección que necesitas.
La pregunta es en qué dirección viaja la llamada. Writ es o bien lo que tu flujo llama, o bien lo que arranca tu flujo — y OAuth es cómo una herramienta guarda tu permiso sin que le pegues una clave.
| Mecanismo | Úsalo cuando |
|---|---|
| Llamar a Writ desde la herramienta | Tu flujo necesita datos de, o una acción sobre, un sitio sin API utilizable. Un paso de petición HTTP lo resuelve. |
| Conectar con OAuth | Prefieres que la herramienta tenga un permiso revocable antes que una clave pegada — y quieres que su pantalla de conexión se configure sola. |
| Recibir eventos de Writ | Un cambio o un run terminado debería arrancar tu flujo, en vez de que tu flujo esté consultando en bucle. |
llamada ▸ petición http
1 · Llama a Writ desde la herramienta.
Publica un workflow como endpoint y apunta ahí el node HTTP Request de la herramienta — o Webhooks by Zapier, o el módulo HTTP de Make. Esa es toda la integración.
http-request-step.sh
curl -X POST https://api.usewrit.app/v1/acme/price-check \
-H "Authorization: Bearer $WRIT_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/product/42"}' HTTP Request node — field by field
{
"method": "POST",
"url": "https://api.usewrit.app/v1/acme/price-check",
"headers": {
"Authorization": "Bearer csk_...",
"Content-Type": "application/json"
},
"body": { "url": "https://example.com/product/42" }
} | Método y URL | POST a la ruta de tu endpoint. |
| Authorization | Una clave de consumidor acuñada para esta única integración, enviada como Bearer. Revócala sin tocar nada más. |
| Cuerpo | JSON, con las entradas que declara tu workflow. |
| Respuesta | Síncrona por defecto: la llamada espera y devuelve el resultado en línea, listo para mapear al siguiente paso. |
Cuando un run dura más de lo que la herramienta espera
Pide una referencia por adelantado. Envía Prefer: respond-async, o añade ?async=true si el paso HTTP de la herramienta no puede poner cabeceras — recibes un 202 y una referencia de run que consultar.
async.sh
curl -X POST https://api.usewrit.app/v1/acme/price-check \
-H "Authorization: Bearer $WRIT_CONSUMER_KEY" \
-H "Prefer: respond-async" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/product/42"}'
# Query-parameter form, for tools whose HTTP step cannot set a header:
curl -X POST "https://api.usewrit.app/v1/acme/price-check?async=true" \
-H "Authorization: Bearer $WRIT_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/product/42"}' El contrato completo del endpoint — rutas, códigos de estado, frescura, consultar una referencia de run — vive en Managed endpoints. Esta página solo repite lo que una herramienta de automatización necesita.
Managed endpoints →oauth ▸ se configura solo
2 · Conecta con OAuth.
Writ ejecuta un servidor OAuth 2.0 de authorization code con PKCE, y publica un documento de descubrimiento en /api/oauth/.well-known/oauth-authorization-server. Las integraciones OAuth genéricas leen ese documento y se configuran solas — endpoints, scopes y método PKCE, sin que escribas ninguno.
discovery.sh
curl https://api.usewrit.app/api/oauth/.well-known/oauth-authorization-server | Tipo de cliente | Cómo se autentica |
|---|---|
| Cliente confidencial | El estilo Zapier/n8n: registra la aplicación y usa su client secret. Aceptado en el token endpoint como client_secret_post o client_secret_basic. |
| Cliente público | PKCE sin secreto alguno. Método de code challenge S256. |
| Device code | Para lo que no puede abrir una redirección de navegador — apruebas desde otro dispositivo. |
Puedes revisar cada aplicación conectada y revocar cualquiera cuando quieras. Poder revocar es justo el motivo de usar OAuth en lugar de pegar una clave duradera en una herramienta de terceros.
eventos ▸ hacia la herramienta
3 · Deja que Writ arranque el flujo.
Todas estas herramientas te dan una URL de recepción — un node Webhook trigger en n8n, un Catch Hook en Zapier, un Custom Webhook en Make. Apunta ahí un monitor o una automatización de Writ y tu flujo arranca cuando algo pasa de verdad.
- 1 · Copia la URL de recepción — Del paso disparador de tu herramienta.
- 2 · Añádela como destinatario webhook en Writ — En el monitor o la automatización que debe arrancar el flujo.
- 3 · Verifica la firma — Las entregas van firmadas con HMAC. Comprueba la firma antes de confiar en el contenido.
El contrato de firma exacto, los nombres de cabecera y un ejemplo de verificación viven en Webhooks. Si tu herramienta no puede verificar una firma dentro del flujo, pon un pequeño paso de código delante — la alternativa es un endpoint al que puede publicar cualquiera.
Webhooks →además ▸ dos puertas más
Otras dos entradas.
No toda herramienta necesita un paso HTTP. Si la tuya ya habla uno de estos, úsalo directamente:
| Cualquier cosa que hable MCP | Apúntala al servidor MCP de Writ y tus workflows llegan como herramientas, sin cablear nada por HTTP. → |
| Cualquier cosa que ya hable con OpenAI | La superficie compatible con OpenAI acepta la misma forma de petición, así que un cliente existente funciona cambiando la URL base. → |
referencia ▸ siguiente
Sigue
El contrato completo de un endpoint publicado.
→ Claves de consumidorUna clave por integración, revocable sola.
→ WebhooksEl contrato de firma, verificado.
→ AutenticaciónFamilias de tokens, scopes, OAuth.
→ MCPWorkflows como herramientas para cualquier cliente MCP.
→ StreamingLa superficie de chat compatible con OpenAI.
→faq
Preguntas de integración, respondidas.
¿Hay un node de Writ para n8n, o una app de Zapier?
¿Cómo autentico el paso HTTP?
Mi run dura más de lo que la herramienta espera. ¿Qué hago?
¿La herramienta configurará OAuth sola?
¿Puedo revocar el acceso de una herramienta más adelante?
¿Necesito algo de esto si mi herramienta habla MCP?
fin ▸ conectar
Publica un endpoint y apunta un paso a él.
Un solo node de petición HTTP es toda la integración, y funciona en todas las herramientas de esta página.