Zgjidhni problemet me dorëzimin e webhooks

Kontrolloni abonimin, regjistrin e dorëzimit dhe përgjigjen e marrësit për të gjetur ku është ndalur ngjarja.

Kontrolloni cila adresë duhet ta pranojë ngjarjen

Hapni Settings → Integrations → Webhooks. Konfirmoni se adresa marrëse është aktive dhe e abonuar në ngjarjen që ju duhet. Leja për webhook-et e llogarisë mbulon adresat, sekretet dhe regjistrat e dorëzimit për të gjithë llogarinë; vetëm leja për CRM nuk e jep këtë qasje.

Për SMS, kontrolloni zgjedhjen e Sender ID. All Sender IDs përfshin çdo ngjarje SMS të abonuar për llogarinë; një listë e përzgjedhur filtrohet sipas dërguesit të mesazhit origjinal. Llojet e tjera të ngjarjeve nuk preken.

Ndryshimi i filtrit nuk i ridërgon ngjarjet e kaluara

Zgjedhjet e dërguesve kontrollohen në çdo tentativë dorëzimi, përfshirë riprovimet. Ndryshimi i tyre nuk i ridërgon ngjarjet e vjetra dhe nuk ndryshon destinacionin e dorëzimeve tashmë në radhë.

Hapni dokumentacionin e webhook-eve

Lexoni tentativën e dorëzimit

Delivery log tregon kohën, statusin, ngjarjen, adresën marrëse, përgjigjen HTTP dhe gabimin. Gjeni ngjarjen dhe adresën e tentativës që po shqyrtoni, pastaj krahasojini me regjistrat e marrësit tuaj.

Nuk ka tentativë përkatëse
Kontrolloni abonimet në ngjarje, gjendjen e adresës marrëse dhe filtrat Sender ID për SMS para se të shqyrtoni kodin e marrësit.
Tentativë e dështuar
Përdorni përgjigjen HTTP ose gabimin e rrjetit për të identifikuar në cilën pjesë të sistemit marrës kërkesa është refuzuar ose nuk ka mbërritur.
Pranim i konfirmuar
Kontrolloni veçmas përpunimin në aplikacionin tuaj. Konfirmimi HTTP nuk dëshmon se kanë përfunduar të gjitha veprimet pasuese.

Nëse firewall-i juaj kufizon kërkesat hyrëse, përdorni listën aktuale të IP-ve të dorëzimit në cilësimet e llogarisë. Verifikoni nënshkrimet edhe kur përdorni listë IP-sh të lejuara.

Kontrolloni fillimisht verifikimin e nënshkrimit

IllyVoIP dërgon kërkesa JSON POST me header-in Illyvoip-Signature . Verifikojeni me sekretin e webhook-ut dhe trupin origjinal të papërpunuar të kërkesës para se ta përpunoni ngjarjen.

Të dhënat që nënshkruhen janë vula kohore, një pikë dhe trupi i papërpunuar. Interpretimi dhe rikodimi i JSON-it para verifikimit mund t'i ndryshojë këto të dhëna. Ndiqni dokumentacionin aktual për procedurën e saktë HMAC SHA-256.

Sekreti i nënshkrimit të webhook-ut është i veçantë nga çelësi API i klientit. Nëse sekreti është zëvendësuar, përditësoni marrësin sipas procedurës suaj të ndryshimit të kredencialeve. Mos zbuloni asnjërin sekret në regjistrat që dërgoni për përkrahje.

Dokumentacioni i nënshkrimit

Kuptoni përgjigjen HTTP

Çdo kod 2xx
Konfirmon dorëzimin. Mjafton edhe një përgjigje bosh 200.
Dështim rrjeti, pa përgjigje, 408, 429 ose 5xx
Mund të riprovohet sipas politikës së dokumentuar të riprovimeve.
3xx ose kode të tjera 4xx
E ndal dorëzimin. Kontrolloni ridrejtimet, rregullat e qasjes dhe validimin te marrësi, në vend që të prisni riprovim automatik.

Konfirmoni shpejt ngjarjet e vlefshme dhe vendoseni punën e ngadalshme në radhë veçmas. Marrësi duhet të mund ta pranojë të njëjtën ngjarje disa herë pa përsëritur veprimet.

Përdorni ID-në e ngjarjes për të shmangur përpunimin e dyfishtë

Ruani fushën id nga trupi si çelës të qëndrueshëm për shmangien e dublikatave. Header-i Illyvoip-Delivery identifikon detyrën e dorëzimit; ai nuk e zëvendëson ID-në e ngjarjes.

Për të lidhur SMS-të me ngjarjet përkatëse, ndiqni dokumentacionin aktual të përgjigjes së dërgimit dhe webhook-eve. ID-të e detyrave të dorëzimit dhe identifikuesit e mesazheve kanë qëllime të ndryshme.

Nëse ju duhet ndihmë, jepni ID-në e ngjarjes, kohën dhe zonën kohore të tentativës, kodin e përgjigjes dhe gabimin e marrësit pa të dhëna sekrete. Mbajini private sekretet e nënshkrimit, çelësat API dhe përmbajtjet e ngjarjeve që nuk lidhen me rastin.

Udhëzues për dorëzimin e SMS-ve