Conecta KoalaPic a tu flujo de trabajo
Automatiza la conversión de imágenes con tus plataformas sin código favoritas o webhooks personalizados.
Cómo Funciona
Obtén una clave de API
Regístrate y crea una clave de API gratuita desde tu panel.
Conecta tu plataforma
Usa tu clave de API para autenticarte con Zapier, Make, n8n o cualquier plataforma de webhooks.
Automatiza las conversiones
Activa conversiones de imágenes automáticamente y recibe los resultados mediante webhooks.
Plataformas compatibles
Zapier
Conecta KoalaPic con más de 7000 aplicaciones. Activa flujos de trabajo cuando se conviertan imágenes, o convierte imágenes como parte de cualquier Zap.
Disparadores compatibles
Acciones mediante la API
Make (Integromat)
Crea escenarios de automatización visual. Usa el módulo HTTP para llamar a la API de KoalaPic y recibir los resultados de la conversión mediante webhooks.
Método de integración
n8n
Automatización de flujos de trabajo autoalojada. Usa el nodo Webhook para recibir eventos de conversión y el nodo HTTP Request para activar conversiones.
Método de integración
Webhooks personalizados
Usa nuestra API REST y webhooks firmados con HMAC-SHA256 para crear integraciones personalizadas con cualquier plataforma o backend.
Características
Widget Insertable
Añade un conversor a tu propio sitio con una sola etiqueta script. Adopta tu color de acento y devuelve los resultados a tu servidor.
Características
Eventos de webhook
Todas las plataformas reciben las mismas cargas JSON planas y fáciles de usar sin código.
| Evento | Descripción |
|---|---|
conversion.started |
La conversión ha comenzado a procesarse |
conversion.completed |
La conversión finalizó correctamente |
conversion.failed |
La conversión encontró un error |
job.completed |
Tarea por lotes finalizada (todas las conversiones completadas) |
test.ping |
Evento de prueba para verificar la conectividad |
Guías de configuración
-
1
Crea una clave de API — Ve a tu Panel → Claves de API y genera una clave nueva.[Screenshot: Dashboard API Keys page]
-
2
Conecta en Zapier — Busca "KoalaPic" en el directorio de aplicaciones de Zapier, o usa un disparador Webhook by Zapier con tu URL de webhook.[Screenshot: Zapier app search]
-
3
Autentícate — Pega tu clave de API cuando se te solicite.[Screenshot: Zapier authentication prompt]
-
4
Elige un disparador — Selecciona qué eventos quieres escuchar.[Screenshot: Zapier trigger selection]
-
5
Crea tu Zap — Añade acciones como guardar en Google Drive, enviar una notificación de Slack o subir a tu CMS.
-
1
Añade un módulo HTTP — En tu escenario de Make, añade un módulo "HTTP → Make a request".
-
2
Configura la solicitud — Establece la URL, el método en POST y añade tu clave de API como encabezado de token Bearer.
-
3
Configura un disparador de webhook — Añade un módulo "Webhooks → Custom webhook" como disparador de tu escenario. Copia la URL del webhook.
-
4
Registra el webhook — En la configuración de Webhooks de tu cuenta de KoalaPic, añade la URL del webhook de Make como tu endpoint.
-
1
Añade un nodo Webhook — Crea un nuevo flujo de trabajo y añade un nodo "Webhook" como disparador. Establece el método HTTP en POST y copia la URL generada.
-
2
Regístralo en KoalaPic — Añade la URL del webhook de n8n en la configuración de Webhooks de tu cuenta de KoalaPic.
-
3
Añade un nodo HTTP Request — Para activar conversiones, añade un nodo "HTTP Request" con tu clave de API en el encabezado Authorization.
-
4
Procesa los resultados — Conecta nodos adicionales para gestionar las cargas del webhook: descargar el archivo convertido, guardarlo en almacenamiento, enviar notificaciones, etc.
Ejemplos de receptor de webhook
Recibe y verifica las cargas de webhook en tu propio backend.
import hmac, hashlib, json
from flask import Flask, request
app = Flask(__name__)
WEBHOOK_SECRET = "your_webhook_secret"
@app.route("/webhook", methods=["POST"])
def handle_webhook():
signature = request.headers.get("X-KoalaPic-Signature")
expected = hmac.new(
WEBHOOK_SECRET.encode(), request.data, hashlib.sha256
).hexdigest()
if not hmac.compare_digest(signature, expected):
return "Invalid signature", 403
payload = request.json
if payload["event"] == "conversion.completed":
download_url = payload["download_url"]
# Process the converted image...
return "OK", 200
const crypto = require("crypto");
const express = require("express");
const app = express();
const WEBHOOK_SECRET = "your_webhook_secret";
app.post("/webhook", express.raw({ type: "application/json" }), (req, res) => {
const signature = req.headers["x-koalapic-signature"];
const expected = crypto
.createHmac("sha256", WEBHOOK_SECRET)
.update(req.body)
.digest("hex");
if (signature !== expected) {
return res.status(403).send("Invalid signature");
}
const payload = JSON.parse(req.body);
if (payload.event === "conversion.completed") {
const downloadUrl = payload.download_url;
// Process the converted image...
}
res.sendStatus(200);
});
¿Necesitas una integración personalizada?
Nuestra API REST admite cualquier plataforma que pueda hacer solicitudes HTTP. Consulta la documentación o ponte en contacto.