Swifty API - Ce este si cum se poate utiliza

Ce este Swifty API?

Swifty API este o solutie avansata care iti permite sa integrezi functionalitatile de marketing si comunicare WhatsApp ale platformei Swifty direct in sistemele si aplicatiile tale.
Dezvoltatorii pot utiliza acest API pentru a automatiza si personaliza interactiunile cu clientii, simplificand procesele de promovare pe WhatsApp.
Cu ajutorul API-ului, poti crea grupuri de contacte, adauga rapid contacte noi si trimite mesaje targetate pentru campanii eficiente si relevante.

Mesajele trimise prin Swifty API pot contine:
Text
Imagini
Video
Linkuri
Documente
Butoane de call to action (ex. "Viziteaza site-ul")
Butoane de call to action (ex. "Raspunde la acest mesaj")
Variabile dinamice atat in text, cat si in linkuri (ex. numele contactului, adresa de email, cod cupon, etc.)

Functionalitati cheie

Trimiterea mesajelor personalizate: Automatizeaza procesul de promovare pe WhatsApp. Trimite notificari pentru cosuri abandonate, plati refuzate, comenzi anulate sau alte interactiuni relevante, oferind clientilor informatii la momentul potrivit.
Campanii WhatsApp eficiente: Faciliteaza campanii targetate si programate care combina text, imagini, si elemente interactive pentru o promovare eficienta.
Gestionarea contactelor: Creeaza si organizeaza contacte direct prin API pentru a mentine o baza de date actualizata si segmentata pentru campanii WhatsApp de succes.

Scenarii de utilizare Swifty API pentru un magazin online

Notificare pentru cos abandonat: Un client adauga produse in cos, dar nu finalizeaza comanda. In loc sa trimiti un email care poate fi ignorat, Swifty API trimite automat o notificare personalizata pe WhatsApp pentru a reaminti clientului sa finalizeze achizitia. Mesajul poate include numele produselor, un link direct catre cosul de cumparaturi si chiar un cod de reducere pentru a incuraja finalizarea comenzii. Folosirea mesajelor pe WhatsApp creste sansele de conversie fata de metodele clasice.

Confirmarea comenzilor plasate: Dupa ce un client plaseaza o comanda, in loc sa ii trimiti un email de confirmare, Swifty API poate trimite un mesaj instant pe WhatsApp cu detaliile comenzii. Notificarea poate include informatii precum numarul comenzii, produsele achizitionate, adresa de livrare si timpul estimat de livrare. In plus, la plasarea comenzii, Swifty API poate salva automat numarul de telefon al clientului in baza de date Swifty, pentru a putea fi ulterior utilizat in campanii de marketing WhatsApp.

Informare despre plati refuzate:
Atunci cand o plata online este refuzata, Swifty API poate notifica rapid clientul pe WhatsApp. Mesajul poate contine informatii despre problema aparuta, link-uri pentru incercarea unei noi plati sau instructiuni pentru alte metode de plata disponibile. Aceasta abordare directa creste sansele ca problema sa fie rezolvata imediat, evitand pierderea comenzilor.

Notificare despre livrarea comenzilor: In loc sa trimiti un email care poate fi trecut cu vederea, utilizeaza Swifty API pentru a trimite pe WhatsApp actualizari despre statusul comenzii. De exemplu, clientul poate primi notificari cand comanda este pregatita, expediata sau livrata. Aceste mesaje rapide si clare imbunatatesc experienta clientului si reduc solicitarile catre serviciul de relatii cu clientii.

Reamintire pentru recenzii sau feedback: Dupa livrarea unei comenzi, cu ajutorul Swifty API poti trimite un mesaj pe WhatsApp pentru a solicita clientului o recenzie sau un feedback. Spre deosebire de emailuri, care sunt adesea ignorate, mesajele pe WhatsApp au o rata de deschidere mult mai mare, motivand clientul sa lase o recenzie sau sa ofere sugestii despre experienta sa.

Avantajele utilizarii WhatsApp in loc de email

Rata de citire mai mare: Mesajele pe WhatsApp sunt deschise si citite rapid, in timp ce emailurile pot ajunge in foldere de spam sau pot fi ignorate.
Interactiune directa: Cliencii pot raspunde imediat, ceea ce face comunicarea mai eficienta.
Personalizare: Mesajele pot include informatii specifice despre comanda sau comportamentul clientului.

Implementand aceste scenarii prin Swifty API, magazinul online poate imbunatati considerabil experienta clientilor si eficienta comunicarii. Swifty API este destinat si campaniilor, dar poate fi folosit pentru a colecta si organiza numere de telefon in baza de date Swifty, pregatind astfel terenul pentru campanii de promovare WhatsApp eficiente.

Cum obtii cheia API Swifty

Cheia API se genereaza pentru organizatia selectata in Swifty. Optiunea este disponibila numai daca planul sau perioada trial permite accesul la Swifty API si utilizatorul are permisiunile necesare.

1. Autentifica-te in Swifty si selecteaza organizatia pentru care doresti cheia.
2. In meniul principal deschide Aplicatii si module Swifty.
3. Alege Swifty API.
4. Apasa Genereaza cheie API.
5. Afiseaza si copiaza cheia din tabelul cu tokenuri, apoi pastreaz-o intr-un manager de secrete.
6. Daca o cheie a fost expusa sau nu mai este folosita, sterge-o din aceeasi pagina si actualizeaza integrarea cu o cheie noua.

Nu publica cheia API in cod sursa, capturi de ecran, documentatie sau mesaje. Cheia autorizeaza accesul la datele organizatiei pentru care a fost generata.

Genereaza cheia API Documentatie API completa

Exemple de utilizare a Swifty API

Toate apelurile folosesc URL-ul de baza https://app.swifty.ro/api si autentificarea Bearer. Inlocuieste valorile dintre paranteze drepte cu datele organizatiei tale.

1. Verificarea cheii API:

curl -X GET 'https://app.swifty.ro/api/verify' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Accept: application/json'

2. Listarea conexiunilor WhatsApp disponibile:

curl -X GET 'https://app.swifty.ro/api/whatsapp-connections' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Accept: application/json'

Foloseste valoarea uuid returnata pentru numarul dorit in campul whatsapp_connection. Acest camp este important cand organizatia are mai multe numere WhatsApp.

3. Listarea grupurilor de contacte:

curl -X GET 'https://app.swifty.ro/api/contact-groups' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Accept: application/json'

4. Crearea sau actualizarea unui contact si adaugarea lui intr-un grup:

Swifty cauta automat contactul dupa numarul de telefon. Daca numarul nu exista, contactul este creat. Daca exista deja, sunt actualizate numai datele trimise in apel. Valoarea append pastreaza grupurile actuale si adauga grupul nou.

curl -X POST 'https://app.swifty.ro/api/contacts/upsert' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "first_name": "Alexandru",
    "last_name": "Popescu",
    "email": "contact@example.com",
    "phone": "+40700000000",
    "group": ["[UUID_GRUP]"],
    "group_mode": "append"
  }'

5. Trimiterea unui template WhatsApp cu text:

curl -X POST 'https://app.swifty.ro/api/send/template' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "phone": "+40700000000",
    "whatsapp_connection": "[UUID_CONEXIUNE_WHATSAPP]",
    "template": {
      "name": "template_cu_text",
      "language": {"code": "ro"}
    }
  }'

6. Trimiterea unui template WhatsApp cu imagine in antet:

curl -X POST 'https://app.swifty.ro/api/send/template' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "phone": "+40700000000",
    "whatsapp_connection": "[UUID_CONEXIUNE_WHATSAPP]",
    "template": {
      "name": "template_cu_imagine_header",
      "language": {"code": "ro"},
      "components": [{
        "type": "header",
        "parameters": [{
          "type": "image",
          "image": {"link": "https://swifty.ro/assets/img/header_image_swifty.png"}
        }]
      }]
    }
  }'

7. Trimiterea unui template cu imagine si variabile dinamice:

curl -X POST 'https://app.swifty.ro/api/send/template' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "phone": "+40700000000",
    "whatsapp_connection": "[UUID_CONEXIUNE_WHATSAPP]",
    "template": {
      "name": "template_cu_variabile",
      "language": {"code": "ro"},
      "components": [
        {
          "type": "header",
          "parameters": [{
            "type": "image",
            "image": {"link": "https://swifty.ro/assets/img/header_image_swifty.png"}
          }]
        },
        {
          "type": "body",
          "parameters": [
            {"type": "text", "text": "Alexandru"},
            {"type": "text", "text": "reducere_25"}
          ]
        }
      ]
    }
  }'

8. Trimiterea unui mesaj liber cu antet, subsol si butoane de raspuns:

Mesajele libere se trimit numai in fereastra WhatsApp de 24 de ore deschisa de un mesaj primit de la contact. In afara ferestrei foloseste un template aprobat de Meta.

curl -X POST 'https://app.swifty.ro/api/send' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "phone": "+40700000000",
    "whatsapp_connection": "[UUID_CONEXIUNE_WHATSAPP]",
    "message": "Salut! Cum te putem ajuta?",
    "header": "Mesaj Swifty",
    "footer": "Alege un raspuns",
    "buttons": [
      {"id": "raspuns_da", "title": "Da"},
      {"id": "raspuns_nu", "title": "Nu"}
    ]
  }'

9. Listarea template-urilor disponibile organizatiei:

curl -X GET 'https://app.swifty.ro/api/templates' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Accept: application/json'

10. Crearea unei campanii cu un template WABA:

Alege din raspunsul GET /api/templates un template aprobat pentru conexiunea WhatsApp folosita. Campul template foloseste UUID-ul randului din Swifty, nu numele public al template-ului Meta. Parametrii din body trebuie sa corespunda exact variabilelor template-ului aprobat.

curl -X POST 'https://app.swifty.ro/api/campaigns' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "name": "Campanie API",
    "whatsapp_connection": "[UUID_CONEXIUNE_WHATSAPP]",
    "contacts": "all",
    "send_immediately": true,
    "template": "[UUID_TEMPLATE_SWIFTY]",
    "header": {"format": "TEXT", "parameters": []},
    "body": {
      "parameters": [
        {"type": "text", "value": "Alexandru"}
      ]
    },
    "footer": {},
    "buttons": []
  }'

11. Verificarea mesajelor unei campanii:

curl -X GET 'https://app.swifty.ro/api/campaigns/[UUID_CAMPANIE]/logs?page=1&per_page=10' \
  -H 'Authorization: Bearer [CHEIE_API_SWIFTY]' \
  -H 'Accept: application/json'

UUID-urile nu sunt interschimbabile: conexiunea WhatsApp, grupul, contactul, template-ul Swifty si campania au fiecare propriul UUID. Pentru toate endpointurile, raspunsurile si exemplele disponibile consulta documentatia tehnica Swifty API.

Avantajele utilizarii Swifty API

Eficienta crescuta: Automatizeaza sarcinile repetitive, economisind timp si resurse.
Promovare WhatsApp personalizata: Adapteaza mesajele si campaniile la comportamentul si preferintele clientilor pentru rezultate mai bune.
Integrare facila: Se integreaza usor cu sistemele si aplicatiile existente, fara a necesita modificari majore.

Cum sa incepi

Genereaza cheia din Aplicatii si module Swifty > Swifty API, verifica accesul prin GET /api/verify, apoi identifica UUID-ul conexiunii WhatsApp inaintea primului apel de trimitere.
Exemplele de pe aceasta pagina folosesc cURL. Documentatia tehnica din aplicatie contine toate endpointurile si exemplele suplimentare disponibile.

Daca ai nevoie de asistenta suplimentara sau ai intrebari specifice, nu ezita sa contactezi.

Contact Suport Cont nou Swifty