receptionworksAjutor

Integrări și webhook-uri

Trimiteți conversații, programări, apeluri către echipă și solicitări de asistență către Zapier, Make sau serverul dvs.; verificați semnătura și livrările.

Integrările trimit evenimentele companiei către alt serviciu imediat ce apar: o conversație nouă, o programare, cererea unui membru al echipei, o solicitare de asistență. Cu Zapier sau Make puteți, de exemplu, să adăugați un rând într-un tabel, să trimiteți un mesaj într-un chat sau să creați o fișă în CRM fără să copiați datele manual.

Unde le găsiți

Deschideți „Module” din meniul de sus, conectați modulul „Integrări” (implicit este dezactivat) și faceți clic pe „Deschide integrările” pe cardul lui. Se deschide fila „Webhook-uri”, iar alături este fila „Jurnal de evenimente”. Secțiunea poate fi deschisă doar de Proprietar și Administrator: adresa unui destinatar poate conține un token privat. Cât timp modulul este dezactivat, nu se livrează nimic, iar evenimentele din acest interval nu vor fi retrimise ulterior. Destinatarii rămân configurați, iar jurnalul de evenimente continuă să fie ținut.

Cum adăugați un destinatar

  1. În Zapier creați un Zap cu declanșatorul „Webhooks by Zapier” și evenimentul „Catch Hook”, apoi copiați adresa primită. În Make adăugați modulul „Custom webhook” și copiați adresa lui.
  2. Pe pagina de integrări completați „Nume” (de exemplu, numele Zapului) și „Adresa destinatarului” (adresa copiată).
  3. În „Evenimente de trimis” bifați ce se trimite.
  4. Faceți clic pe „Adăugați destinatarul”.
  5. Secretul de semnare apare o singură dată. Copiați-l și păstrați-l în siguranță. Zapier și Make nu au nevoie de el; serverul dvs. îl folosește pentru a verifica semnătura. Dacă îl pierdeți, creați unul nou cu „Schimbați secretul”.
  6. Pe fișa destinatarului faceți clic pe „Trimiteți un test”. Rezultatul este Livrat sau Nelivrat, cu motivul.

Adresa trebuie să fie publică și să înceapă cu https. Sunt refuzate, cu motivul indicat: adresele http, adresele IP în loc de domeniu, porturile personalizate, adresele cu utilizator și parolă, adresele interne și adresele de pe domeniile ReceptionWorks. Pagina arată doar domeniul și calea adresei: partea de după semnul întrebării poate conține tokenul destinatarului dvs.

Ce evenimente se trimit

Evenimentele din chatul de test nu se trimit. Un destinatar primește doar evenimentele petrecute după adăugare și cât este activ: ce se întâmplă în timpul unei pauze sau dezactivări nu se trimite ulterior.

„Mesaj nou” și „Conversație completă” conțin textul integral al conversațiilor, inclusiv ce scriu clienții. Textul părăsește ReceptionWorks și ajunge la destinatarul ales de dumneavoastră, deci bifați-le doar pentru destinatari în care aveți încredere. Un destinatar nou începe cu aceste două nebifate. Se trimit doar cât timp un destinatar le are bifate și nu apar în jurnalul de evenimente, nici în exportul lui: conversația în sine este în Inbox. Conversațiile de test și clienții blocați nu se trimit.

Ce primește destinatarul

Fiecare eveniment este o cerere POST cu un corp JSON. Exemplu pentru cererea unui membru al echipei făcută de un angajat AI:

{
  "schema_version": "business-webhook.v1",
  "id": "5b0c5e2e-0000-4000-8000-000000000001",
  "type": "conversation.handoff_requested",
  "occurred_at": "2026-10-07T09:30:00.000Z",
  "business": { "name": "Example Studio" },
  "actor": { "kind": "ai_employee" },
  "channel": "telegram",
  "employee": { "name": "Anna" },
  "conversation": { "url": "https://app.example.com/businesses/studio/inbox?conversation=example" },
  "customer": { "name": "Maria", "email": "maria@example.com", "phone": "+1 555 0100" },
  "booking": null,
  "handoff": { "reason": "ai_request", "reason_text": "The customer wants to discuss a discount" },
  "support_case": null
}

Secțiunile care nu se aplică evenimentului sunt null. Evenimentul din „Trimiteți un test” are tipul webhook.test, iar toate secțiunile în afară de business sunt null. Datele nu conțin text tradus: numele sunt cele salvate, codurile sunt cuvinte englezești fixe, iar orele sunt în UTC.

"message": {
  "id": "6c1d0f52-0000-4000-8000-000000000002",
  "sequence": 12,
  "author": "customer",
  "text": "Hello, can I book for Friday?",
  "created_at": "2026-10-07T09:29:41.000Z",
  "attachments": [{ "kind": "image", "name": "photo.jpg", "media_type": "image/jpeg" }]
}

Mesajele și transcrierile pot sosi în altă ordine și se pot repeta, deci nu vă bazați pe ordinea sosirii. Folosiți sequence pentru a reface ordinea mesajelor dintr-o conversație și ignorați o livrare al cărei webhook-id l-ați procesat deja. Transcrierea repetă mesaje pe care este posibil să le fi primit deja unul câte unul: folosiți-o pentru a verifica sau reconstrui întreaga conversație.

Cum verificați semnătura

Fiecare cerere are trei antete ale standardului Standard Webhooks: webhook-id, webhook-timestamp și webhook-signature. Zapier și Make nu le verifică. Pe serverul dvs. folosiți biblioteca oficială Standard Webhooks pentru limbajul dvs.: dați-i secretul exact cum este afișat (începe cu whsec_), corpul brut nemodificat al cererii și cele trei antete. Verificare manuală:

signed_content = webhook-id + "." + webhook-timestamp + "." + raw request body
signature      = "v1," + base64( HMAC-SHA256( key, signed_content ) )
key            = base64-decoded part of the secret after "whsec_"

Antetul webhook-signature conține v1, și semnătura. După „Schimbați secretul” conține două semnături separate prin spațiu: acceptați cererea dacă oricare se potrivește. Respingeți cererile al căror marcaj de timp diferă de ceasul dvs. cu mai mult de cinci minute.

Reîncercări și dezactivare automată

Destinatarul trebuie să răspundă cu un cod 2xx în 10 secunde. Redirecționările nu sunt urmate: o adresă care redirecționează este considerată eroare. Altfel, ReceptionWorks încearcă din nou: imediat, apoi după 1 minut, 5 minute, 30 de minute, 2 ore, 6 ore și 12 ore. Sunt 7 încercări în aproximativ 21 de ore. Dacă toate eșuează, livrarea apare în „Jurnal de livrări” ca Nelivrat și puteți face clic pe „Trimiteți din nou”. Reîncercările poartă același webhook-id, deci destinatarul poate ignora duplicatele.

Un destinatar este dezactivat automat dacă răspunde că adresa nu mai există (cod 410) sau dacă cinci evenimente la rând nu sunt livrate. Fișa arată atunci „Dezactivat automat” cu motivul, iar echipa dvs. primește o notificare. Corectați adresa și faceți clic pe „Activați”: evenimentele ratate între timp nu se trimit.

Pauză, secret nou, ștergere

Bine de știut

Ce urmează

← Toate articolele