Preskoči na sadržaj
NG CRM
Integracije i API

Javni API je isti API na kome radi aplikacija.

Nema posebnog, siromašnijeg API-ja za partnere. Vaš sistem koristi iste REST pozive kao NG CRM, kroz ključeve sa tačno određenim pravima, a o promenama saznaje preko potpisanih webhook-ova.

  • REST /api/v1
  • Potpisani webhook-ovi
  • OpenAPI i Postman
  • Registri RZS/RGZ
Zakažite demonstracijuSve funkcije
Ilustracija interfejsa sa primerom podataka
Mogućnosti

Šta dobija vaš tim koji radi integraciju

Javni API, potpisani webhook-ovi, zvanični registri i Mailbook — sve što je potrebno da NG CRM radi zajedno sa vašim sistemima.

  • Dostupno

    Ključevi sa opsegom

    Tri kapije: pristup API-ju po pravnom licu, opseg ključa (čitanje ili upis po funkciji) i servisni nalog. Tajna ključa se prikazuje jednom, a čuva se samo otisak.

  • Dostupno

    Kontrola saobraćaja

    Dozvoljene IP adrese, limit po minutu i dnevna kvota, rotacija sa prelaznim periodom i opoziv uz razlog. Dnevnik poziva, bez čuvanja tela zahteva.

  • Dostupno

    Idempotentni pozivi

    Podrška za Idempotency-Key: ponovljen zahtev posle prekida veze ne pravi drugi zapis.

  • Dostupno

    Dokumentacija za deljenje

    OpenAPI (JSON i YAML) i Postman kolekcija, deljivi link sa rokom i lozinkom, i uputstvo za proveru potpisa na pet jezika.

  • Dostupno

    Potpisani webhook-ovi

    Događaji za partnere, kontakte, leadove, prilike, ponude, aktivnosti, tikete i kampanje. HMAC potpis u zaglavlju NgCrm-Signature, samo na javne https adrese.

  • Dostupno

    Isporuka koja se može ponoviti

    Ponovni pokušaji, automatsko gašenje posle uzastopnih grešaka, ponovno slanje izabranog opsega i rotacija tajne sa 24 sata dvostrukog potpisa.

  • Dostupno

    Zvanični registri RZS/RGZ

    Teritorije i adrese iz zvaničnih registara, sedam nivoa do ulice, umesto slobodno kucanih naziva mesta.

  • Dostupno

    Mailbook

    Jedna veza za celu firmu, sa izuzecima po pravnom licu — za Viber razgovore, transakcione poruke i kampanje.

  • Dostupno

    Kalendar Microsoft 365 i Google

    Dvosmerna sinhronizacija kalendara uz povezano sanduče provajdera. Uključujemo je pri uvođenju, uz registraciju aplikacije za vašu instalaciju.

Sve navedene mogućnosti su deo NG CRM-a. Ono što zavisi od vaših spoljnih naloga, poput Microsoft 365 ili Google kalendara, uključujemo pri uvođenju.

Kako radi

Tipična integracija sa vašim sistemom

Na primer, kada prihvaćena ponuda treba da postane porudžbina u vašem poslovnom sistemu.

  1. 01

    Administrator otvara pristup

    Uključuje API za pravno lice i pravi servisni nalog sa ključem samo za potrebne funkcije.

  2. 02

    Vaš tim dobija dokumentaciju

    OpenAPI i Postman kolekciju preko linka sa rokom i lozinkom.

  3. 03

    Webhook javlja promenu

    Kad kupac prihvati ponudu, NG CRM šalje potpisan događaj na vašu https adresu.

  4. 04

    Vaš sistem čita i upisuje

    Proverava potpis, čita ponudu preko API-ja i po potrebi vraća status — sa Idempotency-Key ključem.

Kako razmišljamo o integracijama

NG CRM ostaje CRM

Knjigovodstvo, zalihe i fakturisanje nisu deo proizvoda. Podaci iz tih sistema ulaze i izlaze preko API-ja i webhook-ova, a ne kroz ugrađene module.

Bezbedno po podrazumevanju

Ključ radi samo ono za šta ima opseg, webhook ide samo na javne https adrese, a tajne se ne mogu ponovo pročitati — samo zameniti.

Greška se vidi i popravlja

Dnevnik poziva i dnevnik isporuke webhook-ova pokazuju šta je prošlo, a ponovno slanje opsega rešava propušteno bez ručnog prepisivanja.

Česta pitanja

Da li postoji gotova integracija sa mojim knjigovodstvenim programom?

Ne kao gotov konektor. Vaš sistem se povezuje preko javnog REST API-ja i webhook-ova, uz OpenAPI dokumentaciju i Postman kolekciju koje deli administrator.

Kako proveravam da webhook zaista dolazi iz NG CRM-a?

Svaki događaj nosi HMAC potpis u zaglavlju NgCrm-Signature. Uputstvo za proveru potpisa postoji na pet jezika, a pri rotaciji tajne 24 sata stižu oba potpisa.

Šta ako moj sistem nije bio dostupan?

NG CRM ponavlja isporuku, a posle uzastopnih grešaka gasi webhook da ne bi zatrpao dnevnik. Kada se sistem vrati, izabrani opseg događaja može se poslati ponovo.

Može li ključ da pristupi svim podacima?

Samo onome što mu je dato: API mora biti uključen za pravno lice, ključ ima opseg čitanja ili upisa po funkciji i vezan je za servisni nalog, uz opcionu listu dozvoljenih IP adresa.

Povezano

Želite da vidite kako ovo izgleda u NG CRM-u?

Pokažemo vam na demonstraciji, na primerima iz vaše prodaje. Bez obaveze.

Zakažite demonstraciju