Wennov Connect
API SMS pentru dezvoltatori
Integrezi trimiterea de SMS în aplicația ta printr-un singur apel REST și primești starea reală a livrării prin webhook.
Un apel pentru trimitere, un webhook pentru confirmarea livrării
Fără SDK obligatoriu și fără documentație care nu ține pasul cu implementarea.
API-ul Wennov Connect este un API REST standard, cu autentificare pe bază de cheie. Documentația OpenAPI este generată automat din rutele reale ale platformei, astfel încât rămâne permanent sincronizată cu implementarea.
Vezi documentațiaCe îți oferă API-ul
- Trimitere individuală sau în lot, pe SMS, email, WhatsApp sau voce, cu aceeași structură de cerere
- Interogarea stării unui mesaj: starea de expediere separat de starea reală de livrare confirmată prin DLR
- Interogare în lot pentru sute de mesaje deodată, în loc de un apel pe mesaj
- Webhook-uri semnate pentru mesaj livrat, mesaj eșuat, răspuns primit și dezabonare
- Jurnal de livrare pentru fiecare webhook, cu reîncercare manuală din interfață
- Cereri idempotente: o reîncercare de rețea nu trimite mesajul de două ori
- Chei API cu domeniu de acces limitat, expirare configurabilă și rotire cu perioadă de grație
- Restricționare pe adrese IP și limite de rată pe cheie
- Mediu de test separat, cu mesajele marcate vizibil ca fiind din sandbox
Despre starea de livrare
O greșeală frecventă în integrări este să tratezi răspunsul de la trimitere ca pe o confirmare de livrare. Nu este. Un răspuns de succes înseamnă că mesajul a fost acceptat și pus în coadă. Starea reală apare mai târziu, când operatorul returnează raportul DLR. API-ul nostru separă explicit cele două: un câmp pentru starea de expediere și un câmp pentru starea de livrare confirmată, plus un indicator care îți spune dacă rezultatul este definitiv. Recomandarea noastră este să folosești webhook-uri în loc de interogare repetată.
Întrebări frecvente
Există un SDK oficial?
API-ul este REST standard cu autentificare prin antet, deci funcționează cu orice bibliotecă HTTP din orice limbaj. Publicăm o specificație OpenAPI din care poți genera un client în limbajul tău, dacă preferi.
Cum aflu dacă mesajul a ajuns cu adevărat?
Te abonezi la evenimentele message.delivered și message.failed prin webhook, sau interoghezi endpoint-ul de stare al mesajului. Nu te baza pe răspunsul de la trimitere: acela confirmă doar acceptarea în coadă.
Ce se întâmplă dacă serverul meu este indisponibil când trimiteți un webhook?
Reîncercăm automat, iar fiecare livrare are jurnal propriu pe care îl poți vedea în interfață. Poți reîncerca manual orice livrare eșuată, deci nu pierzi evenimente din cauza unei indisponibilități temporare.
Pot testa fără să trimit mesaje reale?
Da, există un mediu de test. Mesajele trimise în sandbox sunt marcate vizibil în rapoarte, ca să nu fie confundate cu trafic real.
Cum protejez cheile API?
Fiecare cheie are un domeniu de acces limitat, deci o cheie de trimitere nu poate citi baza de contacte. Poți seta expirare, poți restricționa pe adrese IP și poți roti cheia cu o perioadă de grație în care ambele versiuni funcționează.
Ia o cheie API și trimite primul mesaj
Contul gratuit include acces la API și la mediul de test.
Creează contContact
Spune-ne scenariul tău și îți recomandăm configurația potrivită.
Email: office@wennov.ro
Phone: +40 731 177 744
Location: București, România