Integra Chat33
con tu stack.

Endpoint

POST https://chat33.io/api/webhooks/events?token=YOUR_TOKEN

Content-Type: application/json

{
  "event": "purchase",
  "contactId": "cm1abc123...",
  "value": 49.99,
  "currency": "USD",
  "metadata": {
    "product": "Pro Plan",
    "source": "checkout"
  }
}

Cuerpo de la solicitud

Ejemplos

# cURL
curl -X POST "https://chat33.io/api/webhooks/events?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"event":"purchase","value":29.99,"currency":"USD"}'

// Node.js / fetch
await fetch("https://chat33.io/api/webhooks/events?token=YOUR_TOKEN", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    event: "purchase",
    contactId: "cm1abc123...",
    value: 29.99,
    currency: "USD",
  }),
});

La API de conexión para desarrolladores emite un enlace de un solo uso que lleva a uno de tus usuarios a la pantalla de consentimiento OAuth de la propia plataforma, en tu nombre, sin tocar nunca su contraseña. Cuando aprueba, la cuenta conectada se comporta como cualquier otra en la API de publicación en redes de arriba: publicas en ella, lees sus estadísticas donde la plataforma las ofrece y la desconectas, siempre limitada al usuario final ("perfil") al que pertenece.

Cómo funciona

1. Crea un perfil para el usuario (POST /v1/profiles) o reutiliza uno, identificado por tu propio externalId.
2. Solicita un enlace de conexión para ese perfil y una plataforma (POST /v1/connect). Es válido una sola vez, durante 15 minutos.
3. Envía al usuario a la url devuelta. Aprueba en la pantalla de la propia plataforma, que nombra a Chat33 como la app que pide acceso: es lo esperado y nadie ve su contraseña.
4. Vuelve a tu redirectUrl con status, profileId y accountIds (o status=error&code=… si canceló o algo salió mal; un consentimiento cancelado no gasta el enlace).

Crear un perfil

curl -X POST "https://chat33.io/api/v1/profiles" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Fitness",
    "externalId": "user_482"
  }'

Crear un enlace de conexión

curl -X POST "https://chat33.io/api/v1/connect" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prof_abc123",
    "platform": "instagram",
    "redirectUrl": "https://yourapp.com/oauth/done",
    "skipIntro": false
  }'
# -> {"url": "https://chat33.io/connect/...", "expiresAt": "...", "platform": "instagram", "profileId": "prof_abc123"}
# send your user to that url
# skipIntro: true returns a url that goes straight to the platform's consent screen

Lo que ve tu usuario

Una página alojada por Chat33 que nombra tu app, seguida de la pantalla de inicio de sesión y consentimiento de la propia plataforma, que nombra a Chat33 como la app que pide acceso, no a la tuya. Así funciona OAuth por debajo y es lo esperado. Puede revocar el acceso desde la propia plataforma en cualquier momento.

Para omitir la página de introducción y enviar a tu usuario directo a la pantalla de consentimiento de la plataforma, pasa "skipIntro": true al crear el enlace. El enlace pasa a ser una redirección inmediata: el mismo token, los mismos 15 minutos de vigencia, el mismo regreso a tu redirectUrl. Si la omites, avísale a tu usuario en tu propia pantalla que la página de consentimiento nombrará a Chat33, y prefiere enviarlo con un clic en un botón en lugar de un enlace en un correo: los clientes de correo y las apps de chat precargan los enlaces, y la precarga de un enlace con skipIntro abre el diálogo de la plataforma en el escáner (no gasta el token).

Reglas

• Una cuenta real existe una sola vez en todo Chat33: no se puede conectar una segunda vez, ni por ti ni por nadie más, ya sea mediante la API o desde el panel de Chat33.
• Las cuentas conectadas por la API nunca cuentan para el límite de canales del plan de tu organización.
• Chat33 no guarda ni automatiza los mensajes y comentarios entrantes de estas cuentas (la v1 es solo de publicación).
• Facebook conecta todas las páginas a las que el usuario da acceso; cada página es su propia cuenta y su propio cupo.
• Instagram se conecta mediante Instagram Login, para cuentas de empresa o de creador.
• Las publicaciones en X desde cuentas conectadas también descuentan de tu saldo de créditos, igual que las de las cuentas de tu propio panel.

Cuentas en pausa

Una cuenta cuyo cupo estuvo sin pagar durante 7 días se pausa: publicar devuelve 402 account_paused con los accountIds afectados; se reanuda automáticamente cuando recargas. POST /v1/posts, POST /v1/posts/validate y POST /v1/posts/:id/duplicate lo verifican de entrada, antes de poner nada en cola.

// 402
{
  "error": "ACCOUNT_PAUSED",
  "code": "account_paused",
  "message": "These accounts are paused until outstanding connection charges are paid. Top up credits.",
  "accountIds": ["chan_abc123"]
}

Referencia de la API

Activa el permiso

Obtén el permiso connect:write: crea una clave en Configuración → Claves de API y marca Conectar las cuentas de tus usuarios. Viene desactivado por defecto en todas las claves.

Cómo funciona

Cuando usas enlaces con seguimiento en tus automatizaciones, Chat33 los envuelve en una URL de redirección que registra el clic antes de reenviar al destino. El ID del contacto se agrega como parámetro de consulta para que las páginas siguientes puedan identificar al visitante.

# Original URL in your flow:
https://yoursite.com/signup

# What gets sent to the user:
https://chat33.io/api/t?url=https://yoursite.com/signup&cid=cm1abc...&fid=flow123

# User is redirected to:
https://yoursite.com/signup?cid=cm1abc...&fid=flow123

Parámetros de URL agregados