Para desarrolladores

Cyzyra dentro de sus sistemas. Y sus sistemas dentro de Cyzyra.

API REST, webhooks firmados y conexión a asistentes de IA. Para llevar los datos de la empresa a ERP, BI o a tu propia aplicación.

Leer la documentación Abra la plataforma API

curl https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H "Autorización: Portador cy_live_..."

{ "datos": [{ "id": "…", "nombre": "…", "status": "nuevo" }], "next_cursor": nulo }

Ejemplo ilustrativo de llamada y respuesta.

01 / Tres formas de integrarse

Lee, recibe y pregunta.

Utilice uno, dos o los tres. Todos respetan los permisos de la clave y los datos de la empresa propietaria de la misma.

API DESCANSO
Leads, negociaciones, pagos, objetos y métricas en JSON, con documentación OpenAPI.
Ganchos web
18 eventos de empresa enviados a tu sistema al instante, con suscripción.
Asistentes de IA (MCP)
Conecte Cyzyra con asistentes de IA compatibles con MCP y pregunte sobre ventas, publicidad y ganancias.

02 / API REST

Puntos finales

Autenticación por Autorización: Portador, respuestas JSON y paginación del cursor.

120 solicitudes por minuto por clave
Clave almacenada solo como hash

GET/api/v1/leadsListar y buscar clientes potenciales
POST/api/v1/leadsCrear un cliente potencial (con verificación de duplicados)
GET/api/v1/leads/{id}Una pista con los detalles
PATCH/api/v1/leads/{id}Actualizar un cliente potencial
GET/api/v1/dealsNegociaciones y etapas del embudo.
POST/api/v1/dealsCrear un comercio
GET/api/v1/paymentsFacturaciones y pagos
GET/api/v1/objectsTus tipos de objetos
GET/api/v1/objects/{type}/recordsRegistros de un tipo de objeto
POST/api/v1/objects/{type}/recordsCrear un registro
POST/api/v1/queryMétricas con filtros y periodos
POST/api/v1/askPregunta en portugués sobre los datos.

03 / Webhooks

Sucedió en la empresa, llegó a su sistema.

Elige los eventos y la dirección. Cada envío se firma y lo que falla se reenvía hasta 5 veces.

Firma HMAC con tiempo, contra reenvío
Historial de cada intento en el tablero

// Cabeçalho: X-Cyzyra-Signature: t=1731000000,v1=<hmac>
const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
const esperado = hmacSha256(segredo, `${t}.${corpoBruto}`);
if (esperado !== v1) throw new Error("assinatura inválida");

18 eventos disponibles

Lead criadolead.created
Status do lead mudoulead.status_changed
Cadastros unificadoslead.merged
Negociação criadadeal.created
Negociação mudou de etapadeal.stage_changed
Venda ganhadeal.won
Venda perdidadeal.lost
Propuesta enviadaproposal.sent
Propuesta aceptadaproposal.accepted
Proposta recusadaproposal.rejected
Contrato enviadocontract.sent
Contrato assinadocontract.signed
Cargo creadopayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / Asistentes de IA

Pregúntale a Cyzyra desde el interior de tu asistente.

Agregue la dirección MCP de Cyzyra como conector personalizado en un asistente de IA compatible, con su clave API. Comienza a consultar ganancias, campañas y ventas, y responde preguntas en portugués sobre sus datos.

URL: https://SEU-PAINEL/api/mcp Encabezado: Autorización: Portador cy_live_... Herramientas: resumen_beneficio · campañas · solicitud de ventas · gestionar_campañas (escritura)

05 / Preguntas

Preguntas técnicas

Ver integraciones listas para usar

¿Dónde creo la clave API?+

En el panel de la plataforma API (menú Sistema → Plataforma API → Claves API). La clave aparece sólo una vez; Cyzyra solo guarda una versión cifrada.

¿Qué permisos puede tener una clave?+

Leer, o leer y escribir. Acciones como crear clientes potenciales o cambiar campañas a través de la conexión MCP requieren permiso de escritura.

¿Existe un límite de uso?+

Sí: 120 solicitudes por minuto por clave. Por encima de eso, la API responde 429 y le indica cuántos segundos debe intentar nuevamente.

¿Qué pasa si mi sistema no funciona cuando se desconecta un webhook?+

Cyzyra lo reintenta hasta 5 veces, con intervalos crecientes, y muestra cada intento en el tablero.

¿De quién son los datos que ve cada clave?+

Solo de la empresa que creó la clave. Los datos de otras empresas nunca aparecen.

Crea tu cuenta y genera tu primera clave hoy.

Primer mes para US$ 10,00, con acceso completo. Luego, eliges el plan.

Empezar por US$ 10,00

¿Prefieres hablar con una persona? hablar con el equipo

No hay penalización por cancelar · Garantía 30 dias

Ejemplo ilustrativo