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.
• Instagram y Messenger — los mensajes directos de Instagram y de la página de Facebook, por la misma API que WhatsApp (con la ventana de 24 horas de Meta).
• 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.
• Google Calendar — conectar el calendario del negocio con un link y crear, mover y borrar eventos; agenda y horarios ocupados.
• 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; y si querés atender también los DMs de Instagram y Messenger, se conectan desde el panel con la cuenta de Facebook del negocio.

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",
  "channel": "whatsapp",
  "type": "template",
  "status": "sent",
  "to": "5491155555555",
  "message_id": "wamid.HBg...",
  "waba_message_id": "wamid.HBg...",
  "error_code": null,
  "error_message": null,
  "idempotency_key": null,
  "created_at": "2026-05-07T15:30:00Z",
  "updated_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 insufficient_scope. Los scopes disponibles hoy:

Rate limit

60 requests por minuto por API key. El contador es de la key, no del tenant ni del número: dos keys de la misma cuenta tienen 60 cada una, y un tenant no tiene límite propio. Si lo superás, devolvemos 429 Too Many Requests con el header Retry-After en segundos y {"error": "rate_limited"} en el body.

Negocios (tenants)

Cada negocio que operás es un tenant de tu cuenta, identificado por un external_ref que elegís vos (ej. pizzeria-don-mario) y que después usás como tenant_ref en el resto de la API. Los podés crear desde el panel o por API.

GET /v1/tenants

Los negocios de tu cuenta. Scope tenants.read.

GET /v1/tenants
Authorization: Bearer TU_API_KEY

{
  "data": [
    {
      "external_ref": "pizzeria-don-mario",
      "name": "Pizzería Don Mario",
      "contact_name": "Mario",
      "contact_email": "mario@donmario.com.ar",
      "contact_phone": null,
      "connected": true,
      "whatsapp": {
        "display_phone": "+54 9 11 5555-1234",
        "verified_name": "Pizzería Don Mario",
        "waba_id": "1234567890",
        "phone_number_id": "9876543210",
        "connected_at": "2026-05-27T19:34:15+00:00"
      },
      "onboarding_url": "https://waba.galgo.io/connect/tu-cuenta/pizzeria-don-mario",
      "created_at": "2026-05-20T16:26:37+00:00"
    }
  ]
}

connected dice si el negocio tiene WhatsApp conectado; whatsapp es null si no. onboarding_url es el link que le pasás al negocio para que conecte (o reconecte) su número.

GET /v1/tenants/{external_ref}

Un negocio, con la misma forma que cada item de la lista. Scope tenants.read.

GET /v1/tenants/pizzeria-don-mario

POST /v1/tenants

Registrar un negocio nuevo. Scope tenants.write.

POST /v1/tenants
{
  "external_ref": "pizzeria-don-mario",
  "name": "Pizzería Don Mario",
  "contact_name": "Mario",
  "contact_email": "mario@donmario.com.ar",
  "contact_phone": "5491155551234",
  "notes": "Cliente de la zona norte"
}

Obligatorios: external_ref y name. Devuelve 201 con el negocio creado (incluido su onboarding_url). Si el external_ref ya existe en tu cuenta, 409 duplicate_external_ref; si tu plan no tiene cupo para otro negocio, 422 quota_exceeded.

POST /v1/tenants/{external_ref}/disconnect

Desconecta el WhatsApp del negocio: le decimos a Meta que deje de mandarnos sus mensajes y recién ahí lo marcamos como desconectado. Scope tenants.write.

POST /v1/tenants/pizzeria-don-mario/disconnect

{
  "ok": true,
  "tenant_ref": "pizzeria-don-mario",
  "status": "disconnected",
  "disconnected_at": "2026-09-16T04:00:00+00:00"
}

Si Meta rechaza la desconexión, 502 meta_disconnect_failed y no marcamos nada: el negocio sigue conectado y podés reintentar. Si no tenía nada conectado, 409 not_connected.

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
}

La excepción son los errores de validación (falta un campo, o tiene un formato que no corresponde): vienen con 422 y otra forma, con el detalle por campo:

{
  "message": "The tenant ref field is required.",
  "errors": {
    "tenant_ref": ["The tenant ref field is required."]
  }
}

Algunos errores que vienen de Meta (por ejemplo en plantillas) suman meta_subcode y meta_detail con el motivo exacto cuando el message de Meta es genérico. Si están presentes, son la pista más útil para corregir el request.

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 ya existe un mensaje enviado con esa key en tu cuenta, no se manda de nuevo: te devolvemos ese mensaje con 200 (en vez del 201 de un envío nuevo). Dos cosas a tener en cuenta:

• La key no vence. Queda atada a ese mensaje para siempre: no la reuses para un mensaje distinto.
• No comparamos el body. Si mandás la misma key con otro contenido, te devolvemos el mensaje original y el nuevo no sale.

Vacía o con más de 255 caracteres devuelve 422 invalid_idempotency_key.

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

Crear un evento de Google Calendar también acepta Idempotency-Key, con una diferencia: la key vale por negocio (dos negocios pueden usar el mismo código). Ver Crear un evento.

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ó.