Dla programistów

Cyzyra w Twoich systemach. A Twoje systemy w Cyzyrze.

REST API, podpisane webhooki i połączenie z asystentami AI. Aby przenieść dane firmowe do ERP, BI lub własnej aplikacji.

Przeczytaj dokumentację Otwórz platformę API

curl https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H "Autoryzacja: Bearer cy_live_..."

{ "dane": [{ "id": "...", "nazwa": "...", "status": "nowy" }], "next_cursor": null }

Ilustrujący przykład wezwania i odpowiedzi.

01 / Trzy sposoby integracji

Czytaj, otrzymuj i pytaj.

Użyj jednego, dwóch lub wszystkich trzech. Wszyscy szanują uprawnienia klucza i dane firmy, która jest jego właścicielem.

API RESTOWE
Leady, negocjacje, płatności, obiekty i metryki w JSON, z dokumentacją OpenAPI.
Haki internetowe
18 wydarzeń firmowych wysyłanych natychmiast do Twojego systemu, w ramach subskrypcji.
Asystenci AI (MCP)
Połącz Cyzyrę z asystentami AI kompatybilnymi z MCP i pytaj o sprzedaż, reklamę i zysk.

02 / API REST

Punkty końcowe

Uwierzytelnianie przez Autoryzacja: na okaziciela, odpowiedzi JSON i paginacja kursora.

120 żądań na minutę na klucz
Klucz przechowywany tylko jako skrót

GET/api/v1/leadsLista i wyszukiwanie potencjalnych klientów
POST/api/v1/leadsUtwórz potencjalnego klienta (z sprawdzaniem duplikatów)
GET/api/v1/leads/{id}Ołów ze szczegółami
PATCH/api/v1/leads/{id}Zaktualizuj potencjalnego klienta
GET/api/v1/dealsNegocjacje i etapy lejka
POST/api/v1/dealsUtwórz transakcję
GET/api/v1/paymentsRozliczenia i płatności
GET/api/v1/objectsTwoje typy obiektów
GET/api/v1/objects/{type}/recordsRekordy typu obiektowego
POST/api/v1/objects/{type}/recordsUtwórz rekord
POST/api/v1/queryMetryki z filtrami i okresami
POST/api/v1/askPytanie w języku portugalskim dotyczące danych

03 / Webhooki

Stało się to w firmie, dotarło do Twojego systemu.

Wybierz wydarzenia i adres. Każde zgłoszenie jest podpisane, a to, co się nie powiedzie, jest wysyłane ponownie maksymalnie 5 razy.

Podpis HMAC z czasem, przed ponownym wysłaniem
Historia każdej próby na desce rozdzielczej

// 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 dostępne wydarzenia

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
Propozycja wysłanaproposal.sent
Propozycja przyjętaproposal.accepted
Proposta recusadaproposal.rejected
Umowa wysłanacontract.sent
Contrato assinadocontract.signed
Utworzono opłatępayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / Asystenci AI

Zapytaj Cyzyrę z wnętrza swojego asystenta.

Dodaj adres MCP Cyzyry jako niestandardowe złącze w kompatybilnym asystencie AI, za pomocą klucza API. Zaczyna konsultować zyski, kampanie i sprzedaż oraz odpowiada po portugalsku na pytania dotyczące swoich danych.

URL: https://SEU-PAINEL/api/mcp Nagłówek: Autoryzacja: Bearer cy_live_... Narzędzia: podsumowanie_zysk · kampanie · zapytanie sprzedażowe · zarządzaj_kampaniami (pisanie)

05 / Pytania

Pytania techniczne

Zobacz gotowe integracje

Gdzie mogę utworzyć klucz API?+

W panelu API Platformy (menu System → Platforma API → Klucze API). Klucz pojawia się tylko raz; Cyzyra przechowuje jedynie jego zaszyfrowaną wersję.

Jakie uprawnienia może mieć klucz?+

Czytanie, czyli czytanie i pisanie. Działania takie jak tworzenie potencjalnych klientów lub zmiana kampanii za pośrednictwem połączenia MCP wymagają uprawnień do zapisu.

Czy istnieje limit wykorzystania?+

Tak: 120 żądań na minutę na klucz. Poza tym interfejs API odpowiada 429 i informuje, ile sekund należy spróbować ponownie.

Co się stanie, jeśli mój system ulegnie awarii po wyłączeniu webhooka?+

Cyzyra ponawia próbę do 5 razy, w coraz większych odstępach czasu, a każdą próbę wyświetla na pulpicie nawigacyjnym.

Czyje dane widzi każdy klucz?+

Tylko od firmy, która stworzyła klucz. Dane innych firm nigdy się nie pojawiają.

Utwórz konto i wygeneruj swój pierwszy klucz już dziś.

Pierwszy miesiąc dla US$ 10,00, z pełnym dostępem. Następnie wybierasz plan.

Zacznij od US$ 10,00

Wolisz rozmawiać z osobą? Porozmawiaj z zespołem

Nie ma kary za anulowanie · Gwarancja 30 dias

Przykład ilustrujący