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 nu este destinat 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.

Exemple de utilizare a Swifty API

Adaugare contact intr-un grup existent:

curl -X POST https://app.swifty.ro/api/contacts 
-H 'Authorization: Bearer [TOKEN_API]' 
-H 'Content-Type: application/json' 
-d '{
  "first_name": "First Name",
  "last_name": "Last Name",
  "email": "contact@example.com",
  "phone": "+40700000000",
  "group": "957d668d-b47f-43f5-996d-21c757e13dc0"
}'

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

curl -X POST 'https://app.swifty.ro/api/send/template'
-H 'Authorization: Bearer [TOKEN_API]'
-H 'Content-Type: application/json'
-d '{
  "phone": "+40700000000",
  "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"
            }
          }
        ]
      }
    ]
  }
}'

curl -X POST 'https://direct.swifty.ro/api/send/template' 
-H 'Authorization: Bearer [TOKEN_API]' 
-H 'Content-Type: application/json' 
-d '{
  "phone": "+40700000000",
  "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"
          }
        ]
      }
    ]
  }
}'

curl -X POST 
    https://app.swifty.ro/api/send 
    -H 'Authorization: Bearer [TOKEN_API]' 
    -H 'Content-Type: application/json' 
    -d '{
      "phone": "+40700000000",
      "message": "Salut Vlad! Cum te simti azi",
      "header": "Header text",
      "footer": "Footer text",
      "buttons": [
        {
          "id": "id_1", 
          "title": "Foarte bine"
        },
        {
          "id": "id_2", 
          "title": "Nu prea bine"
        }
      ]
    }'

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

Documentatia API si cheia Swifty API pot fi obtinute dupa ce te loghezi in platforma Swifty si accesezi sectiunea "Developer Tools".
Codul pentru utilizarea API este disponibil in multiple limbaje de programare, inclusiv curl, PHP, Python, Node.js, Java si Ruby.

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