Introducción

Todo lo que necesitas para integrar Sofia Chat con tu CRM, ERP o cualquier sistema: envía mensajes de WhatsApp, consulta conversaciones, sincroniza contactos y lanza campañas sin pasar por el panel. Aquí están los conceptos; la Referencia de API tiene cada endpoint con su esquema y un cliente para probarlo.

Campo	Valor
URL base	`https://api-v2.sofiachat.com/api/v1`
Autenticación	Header `X-API-Key` (ver Autenticación)
Formato	JSON (UTF-8) en cuerpo de petición y respuesta. `Content-Type: application/json`
Zona horaria	Todas las fechas son ISO 8601 en UTC (`2026-08-25T03:14:16.549Z`)
Referencia interactiva	Referencia de API — el esquema completo, generado desde OpenAPI, con un cliente para probar cada endpoint.

La API v1 es independiente del panel: usa métodos REST estándar (GET, POST, PATCH, DELETE) y no requiere sesión de usuario. Esta guía cubre autenticación, formato, errores y un tutorial de campaña; el listado de endpoints, campos y respuestas de ejemplo vive en la Referencia de API.

Primer request en 30 segundos

Este es el endpoint GET /v1/me: devuelve la organización de la key, el plan con límites y consumo, y los datos de la propia key.

curl https://api-v2.sofiachat.com/api/v1/me \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const res = await fetch("https://api-v2.sofiachat.com/api/v1/me", {
  headers: { "X-API-Key": process.env.KEY },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api-v2.sofiachat.com/api/v1/me",
    headers={"X-API-Key": KEY},
)
data = res.json()

Respuesta

{
  "data": {
    "organization": { "id": 3, "name": "Mi Empresa", "type": "production" },
    "plan": {
      "name": "Growth",
      "limits": { "conversations": 5000, "users": 10, "departments": 3, "integrations": 3, "tools": 10 },
      "usage":  { "conversations": 1240, "users": 6,  "departments": 1, "integrations": 2, "tools": 4 }
    },
    "apiKey": { "id": 7, "name": "Integración CRM", "scopes": ["read","write"], "expiresAt": null }
  }
}

Ábrelo en la Referencia de API para probarlo con tu key.

Empezar

Guía práctica

Referencia

Primer request en 30 segundos

​Primer request en 30 segundos

Primer request en 30 segundos