Documentación

SinapsIA Connect es un gateway HTTP entre tu sistema y WhatsApp. Tu aplicación nunca habla con WhatsApp directamente.

Tu app  ──HTTP──>  SinapsIA Gateway  ──>  WhatsApp
        <──webhook──

Quickstart (4 pasos)

  1. Obtener API key — Ingresá a tu portal y copiá la key desde el dashboard.
  2. Crear instancia — POST /instance/create con el nombre y tu webhook URL.
  3. Escanear QR — GET /instance/:name/qr y mostrárselo al usuario (o usar pairing code).
  4. Enviar mensajes — POST /message/text y los demás endpoints.
bash
# 1. Crear instancia
curl -X POST https://wa.sinapsia.com.ar/instance/create \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instanceName":"acme__soporte__main","webhookUrl":"https://mi-app.com/wh","webhookSecret":"mi-secreto-minimo-16"}'

# 2. Obtener QR y mostrarlo al usuario
curl https://wa.sinapsia.com.ar/instance/acme__soporte__main/qr \
  -H "apikey: TU_API_KEY"
# → { "qrcode": "data:image/png;base64,..." }

# 3. Verificar estado (esperar state: "open")
curl https://wa.sinapsia.com.ar/instance/acme__soporte__main/status \
  -H "apikey: TU_API_KEY"

# 4. Enviar primer mensaje
curl -X POST https://wa.sinapsia.com.ar/message/text \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instanceName":"acme__soporte__main","to":"5491112345678","text":"Hola!","lane":"normal"}'

Conceptos clave

  • Instancia: un número de WhatsApp vinculado. Formato: tenantId__clientId__label (solo minúsculas, números, guiones).
  • Carril: velocidad de envío (urgent, normal, bulk). Controla delays anti-ban.
  • Webhook: URL en tu app donde el gateway envía mensajes entrantes y eventos de conexión.
  • Spintax: variaciones automáticas de texto, ej: {Hola|Hey}!.