Webhook’ai ir REST API

Conviro siūlo webhook’us pranešimams apie įvykius realiuoju laiku ir REST API programinei prieigai prie visų platformos funkcijų.

Webhook’ai

Kas yra webhook’ai?

Webhook’ai išsiunčia HTTP POST užklausą į jūsų serverį kaskart, kai Conviro sistemoje įvyksta tam tikras įvykis. Taip galite reaguoti realiuoju laiku ir jums nereikia nuolat siųsti užklausų (polling).

Galimi įvykiai

Įvykis	Kada suveikia
`message.new`	Išsiunčiama nauja žinutė (lankytojo arba boto)
`session.started`	Prasideda nauja pokalbio sesija
`session.closed`	Pokalbis uždaromas
`session.handoff`	Pokalbis perduodamas gyvam operatoriui
`lead.captured`	Užfiksuojamas naujas potencialus klientas
`contact.created`	Sukuriamas naujas kontaktas
`ticket.created`	Atidaroma pagalbos užklausa
`csat.submitted`	Pateikiamas CSAT įvertinimas

Nustatymas

Eikite į Dashboard -> Settings -> Webhooks.
Spustelėkite Add Webhook.
Įveskite savo galinio taško URL (turi būti HTTPS).
Pasirinkite įvykius, kuriuos norite gauti.
Spustelėkite Save.

Sauga: pasirašymas HMAC-SHA256

Kiekvienas webhook’o duomenų paketas pasirašomas HMAC-SHA256 algoritmu naudojant jūsų webhook’o slaptąjį raktą. Kad įsitikintumėte autentiškumu, patikrinkite parašą savo serveryje:

X-Conviro-Signature: sha256=<hex_digest>

Palyginkite šią antraštę su neapdorotos užklausos turinio HMAC-SHA256 santrauka, apskaičiuota naudojant jūsų webhook’o slaptąjį raktą.

Pakartojimo politika

Jei jūsų galinis taškas grąžina ne 2xx būsenos kodą, Conviro kartoja bandymus iki 3 kartų taikydama eksponentinę delsą (1 min., 5 min., 30 min.).

REST API

Autentifikavimas

Sugeneruokite API raktą čia: Dashboard -> Settings -> API Keys -> Create Key.
Įtraukite jį į Authorization antraštę:

Authorization: Bearer sk_your_api_key_here

Pagrindiniai galiniai taškai

Metodas	Galinis taškas	Aprašymas
GET	`/api/chatbots`	Pateikia visų chatbot’ų sąrašą
GET	`/api/chatbots/:id`	Grąžina chatbot’o informaciją
GET	`/api/sessions`	Pateikia sesijų sąrašą (su filtrais)
GET	`/api/sessions/:id/messages`	Grąžina sesijos žinutes
POST	`/api/sessions/:id/messages`	Išsiunčia žinutę į sesiją
GET	`/api/contacts`	Pateikia kontaktų sąrašą
POST	`/api/contacts`	Sukuria kontaktą
GET	`/api/leads`	Pateikia potencialių klientų sąrašą
POST	`/api/leads`	Sukuria potencialų klientą
GET	`/api/analytics/overview`	Grąžina analitikos suvestinę

Užklausų limitai

Free planas: 60 užklausų per minutę
Starter: 120 užklausų per minutę
Pro: 300 užklausų per minutę
Growth+: 600 užklausų per minutę

Užklausų limito antraštės įtraukiamos į kiekvieną atsakymą:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 298
X-RateLimit-Reset: 1672531200

Visa dokumentacija

Išsamų API žinyną su užklausų ir atsakymų pavyzdžiais rasite adresu /developers.