Documentación

Sabado Cloud es una plataforma B2B que te conecta a varios servicios (WhatsApp Business como Tech Provider de Meta, MercadoPago como marketplace para cobros con split, correo electrónico gestionado con tu propio dominio, y facturación electrónica ARCA) detrás de una sola API REST y un solo set de webhooks firmados. Acá tenés todo lo que necesitás para integrarte.

Cómo se organizan estos docs

La doc está partida por servicio: cada servicio soportado tiene su propia sección en la barra lateral. Esta página cubre lo común a todos (autenticación, errores, idempotencia). Los endpoints específicos viven en su sección.

• WhatsApp Cloud API — mandar y recibir mensajes, plantillas, perfil del negocio, estado del número, estadísticas.
• MercadoPago split — conectar el MP del comercio por OAuth, cobrar con un fee de plataforma y cancelar/reembolsar.
• Correo (email) — conectar un dominio, configurar su DNS, crear casillas y alias, y leer / enviar mensajes por API.
• Facturación (ARCA) — emitir comprobantes electrónicos (Factura C / A / B) por el CUIT del negocio, con delegación de Clave Fiscal.
• Webhooks — recibir eventos firmados (mensajes entrantes, cambios de estado, pagos aprobados / rechazados / reembolsados, etc.).
• Onboarding — cómo el cliente final conecta su WhatsApp (Embedded Signup con coexistence o migration).

Cuando agreguemos un servicio nuevo, va a aparecer como una sección propia (/docs/<servicio>/) con su propio set de endpoints. La estructura del sidebar y los conceptos comunes (autenticación, errores, webhooks) se mantienen.

Quickstart de 5 minutos

Asumimos que ya tenés acceso al panel en https://waba.galgo.io/customer. Si todavía no, escribinos a contacto@sabado.cloud y te damos uno.

1. Emitir tu primera credencial

Andá a API keys en tu panel y hacé click en Emitir credencial. Ponele un nombre (por ejemplo, Producción), guardá el secret que te aparece — es la única vez que lo vas a ver completo.

Cada credencial tiene un set de scopes (permisos granulares). Pedí solo los que necesitás: messages.send para mandar WhatsApp, mercadopago.write para cobrar, etc. La lista completa la ves en el panel cuando emitís la key.

2. Registrar tu primer negocio

En Tus negocios, click en Registrar negocio nuevo. Completá el nombre y un identificador interno (ej: pizzeria-don-mario) que vas a usar en la API.

Compartile al negocio el link de onboarding que te damos abajo. Cuando entren, conectan su WhatsApp Business sin perder el uso de la app del celular. Si además vas a cobrar con MercadoPago, el comercio conecta su cuenta MP por un botón aparte del panel.

3. Mandar tu primer mensaje

Una vez que el negocio conectó su WhatsApp, podés enviar mensajes con plantillas pre-aprobadas. Por ejemplo, la plantilla hello_world que viene cargada por default:

curl -X POST "https://waba.galgo.io/v1/messages" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_ref": "pizzeria-don-mario",
    "to": "5491155555555",
    "type": "template",
    "template": {
      "name": "hello_world",
      "language": "en_US"
    }
  }'

La respuesta tiene este formato:

{
  "id": "019dcf...",
  "tenant_ref": "pizzeria-don-mario",
  "type": "template",
  "status": "sent",
  "to": "5491155555555",
  "waba_message_id": "wamid.HBg...",
  "created_at": "2026-05-07T15:30:00Z"
}

Para el detalle completo (tipos de mensaje, media, interactivos, templates, etc.) andá a WhatsApp Cloud API. Para cobros con MercadoPago, MercadoPago split.

4. Ver tu uso

Volvé a tu panel, andá a Uso y vas a ver el conteo de mensajes enviados, recibidos y entregas de webhook.

Conceptos clave

Autenticación

Cada request va con el header Authorization: Bearer TU_API_KEY. El secret completo se muestra una sola vez al emitir la credencial.

Authorization: Bearer gwk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890

Si perdiste el secret, emití uno nuevo, actualizá tu sistema y revocá el anterior. No mantenemos copia del secret, solo un hash con sal.

Scopes

Cada API key tiene una lista de scopes. Cada endpoint requiere uno específico — si tu key no lo tiene, recibís 403 forbidden_scope. Los scopes disponibles hoy:

Rate limit

60 requests por minuto por API key. Si lo superás, devolvemos 429 Too Many Requests con header Retry-After en segundos.

Errores

Las respuestas de error tienen este formato:

{
  "ok": false,
  "error": "meta_recipient_unreachable",
  "message": "El número de destino no está en el allowlist de testers.",
  "meta_code": 131030
}

Idempotencia

Para evitar enviar el mismo mensaje dos veces si tu sistema reintentó un POST que ya había salido, agregá el header Idempotency-Key con un UUID o string único de tu sistema:

curl -X POST "https://waba.galgo.io/v1/messages" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Idempotency-Key: pedido-12345-confirmacion" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Si recibimos dos veces la misma key con el mismo body, devolvemos la misma respuesta — no enviamos el mensaje dos veces. Las keys quedan guardadas durante 24 horas.

Para reembolsos de MercadoPago hay idempotencia interna por payment_id — reintentar el mismo refund no genera un segundo reembolso. Ver Cancelar / reembolsar.

Soporte

¿Algo no anda como esperabas? Escribinos a contacto@sabado.cloud. Somos pocos y respondemos rápido — sobre todo si nos das el ID de la request o del evento que falló.