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.
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
Krijoni, ndryshoni dhe hiqni endpoint-in
Te Integrimet → Webhooks zgjidhni Add webhook, vendosni URL HTTPS dhe vetëm ngjarjet e nevojshme. Kontrolloni filtrat e dërguesit SMS kur zbatohen dhe ruani. Ruajeni sekretin e nënshkrimit në mënyrë të sigurt kur shfaqet; nuk është çelësi API i llogarisë.
Përdorni Edit te endpoint-i i saktë për emërtimin, ngjarjet, filtrat ose gjendjen aktive. URL-ja nuk ndryshohet: krijoni endpoint tjetër për URL të re, përditësoni sekretin te marrësi dhe hiqni të vjetrin kur jeni gati. Konfirmoni rreshtin e ruajtur para provës. Endpoint-e të dyfishta mund të dërgojnë njoftime të veçanta te i njëjti marrës. Hiqni të vjetrin vetëm pasi të kontrolloni aplikacionin që e përdor; heqja nuk zhbën ngjarjet e përpunuara atje.
Koordinoni ndryshimin e sekretit
Ndryshoni sekretin vetëm kur jeni gati të përditësoni aplikacionin marrës. Lexoni konfirmimin, ruajeni sekretin e ri sigurt dhe përditësoni marrësin para mbështetjes te dërgesat e tjera. Mos supozoni se sekreti i vjetër punon pafund ose se ndryshimi ridërgon historikun. Regjistri i dorëzimit është pamje e fundit për diagnostikim, jo arkiv i plotë; mbani regjistrat tuaj të sigurt të ngjarjeve dhe përpunimit.