Для розробників

Cyzyra у ваших системах. І ваші системи в Cyzyra.

REST API, підписані вебхуки та підключення до помічників AI. Щоб перенести дані компанії в ERP, BI або власну програму.

Прочитайте документацію Відкрийте платформу API

curl https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H "Авторизація: носій cy_live_..."

{ "data": [{ "id": "…", "name": "…", "status": "new" }], "next_cursor": null }

Наочний приклад виклику та відповіді.

01 / Три способи інтеграції

Читайте, отримуйте і запитуйте.

Використовуйте один, два або всі три. Усі вони поважають дозволи ключа та дані компанії, яка ним володіє.

REST API
Потенційні клієнти, переговори, платежі, об’єкти та показники в JSON із документацією OpenAPI.
Веб-хуки
Події компанії (18) миттєво надсилаються у вашу систему за підпискою.
Помічники AI (MCP)
Підключіть Cyzyra до MCP-сумісних AI-помічників і запитайте про продажі, рекламу та прибуток.

02 / REST API

Кінцеві точки

Автентифікація за Авторизація: на пред'явника, відповіді JSON і розбивка курсору на сторінки.

120 запитів в хвилину на ключ
Ключ зберігається лише як хеш

GET/api/v1/leadsСписок і пошук потенційних клієнтів
POST/api/v1/leadsСтворення потенційного клієнта (з перевіркою дублікатів)
GET/api/v1/leads/{id}Лід з деталями
PATCH/api/v1/leads/{id}Оновіть потенційного клієнта
GET/api/v1/dealsПереговори та етапи воронки
POST/api/v1/dealsСтворіть торгівлю
GET/api/v1/paymentsРахунки та платежі
GET/api/v1/objectsВаші типи об’єктів
GET/api/v1/objects/{type}/recordsЗаписи типу об'єкта
POST/api/v1/objects/{type}/recordsСтворіть запис
POST/api/v1/queryМетрики з фільтрами та періодами
POST/api/v1/askЗапитання португальською щодо даних

03 / Веб-хуки

Це сталося в компанії, воно потрапило у вашу систему.

Виберіть події та адресу. Кожне подання підписується, а те, що не вдається, надсилається повторно до 5 разів.

Підпис HMAC із часом, без повторного надсилання
Історія кожної спроби на приладовій панелі

// 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 доступні події

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
Пропозиція надісланаproposal.sent
Пропозиція прийнятаproposal.accepted
Proposta recusadaproposal.rejected
Договір надісланоcontract.sent
Contrato assinadocontract.signed
Заряд створеноpayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / А. І. Пом

Запитайте Cyzyra у свого помічника.

Додайте MCP-адресу Cyzyra як спеціальний з’єднувач у сумісному помічнику зі штучним інтелектом із вашим ключем API. Він починає консультуватися з питань прибутку, кампаній і продажів і відповідає на запитання португальською мовою про свої дані.

URL: https://SEU-PAINEL/api/mcp Заголовок: Авторизація: носій cy_live_... Інструменти: summary_profit · кампанії · продажі запитів · manage_campaigns (написання)

05 / Питання

Технічні питання

Переглянути готові інтеграції

Де створити ключ API?+

На інформаційній панелі платформи API (меню Система → Платформа API → Ключі API). Ключ з'являється лише один раз; Cyzyra зберігає лише його зашифровану версію.

Які дозволи може мати ключ?+

Читання, або читання і письмо. Такі дії, як створення потенційних клієнтів або зміна кампаній через з’єднання MCP, потребують дозволу на запис.

Чи є обмеження на використання?+

Так: 120 запитів на хвилину на ключ. Крім того, API відповідає 429 і повідомляє вам, через скільки секунд потрібно повторити спробу.

Що робити, якщо моя система не працює, коли вебхук вимикається?+

Cyzyra повторює спроби до 5 разів із збільшенням інтервалів і відображає кожну спробу на інформаційній панелі.

Чиї дані бачить кожен ключ?+

Тільки від компанії, яка створила ключ. Дані інших компаній ніколи не з'являються.

Створіть свій обліковий запис і згенеруйте свій перший ключ сьогодні.

Перший місяць для US$ 10,00, з повним доступом. Потім ви обираєте план.

Почніть для US$ 10,00

Бажаєте поговорити з людиною? Поговоріть з командою

Немає штрафу за скасування · Гарантія 30 dias

Наочний приклад