Для разработчиков

Cyzyra в ваших системах. И ваши системы внутри Сайзыры.

REST API, подписанные вебхуки и подключение к ИИ-помощникам. Чтобы перенести данные компании в ERP, BI или ваше собственное приложение.

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

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

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

Наглядный пример вызова и ответа.

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

Читайте, получайте и спрашивайте.

Используйте один, два или все три. Все они уважают разрешения ключа и данные компании, которая им владеет.

ОТДЫХ API
Лиды, переговоры, платежи, объекты и метрики в формате JSON, с документацией OpenAPI.
Вебхуки
18 корпоративные мероприятия отправляются в вашу систему мгновенно по подписке.
AI-помощники (MCP)
Подключите Cyzyra к MCP-совместимым ИИ-помощникам и спрашивайте о продажах, рекламе и прибыли.

02 / ОСТАЛЬНОЙ 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 / ИИ-помощники

Спросите Цизыру изнутри своего помощника.

Добавьте адрес MCP Cyzyra в качестве специального соединителя в совместимом помощнике AI с помощью вашего ключа 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

Показательный пример