Μετάβαση στο περιεχόμενο

Counterbat API: Viber Bot Billing Sessions

Δυνατότητες μετρητή χρέωσης

Το Counterbat API σάς επιτρέπει να παρακολουθείτε δεδομένα περιόδου σύνδεσης σε πραγματικό χρόνο και να αξιοποιείτε το Cascade API για να στέλνετε πρόσθετα μηνύματα σε μια περίοδο λειτουργίας υπηρεσίας ή σε μια ήδη πληρωμένη περίοδο λειτουργίας Viber Bot.

Πώς να συνδέσετε την υπηρεσία γκισέ χρεώσεων

  1. Υπογράψτε συμβόλαιο.
  2. Αποκτήστε πρόσβαση στη λειτουργικότητα.
  3. Ρύθμιση webhook.
  4. Χρησιμοποιήστε τον πίνακα και τις δυνατότητες του Cascade API.

Viber REST API (Έκδοση Counterbat)

Το παρακάτω είναι μια πλήρης αναφορά του Viber REST API. Σημειώστε ότι το τελικό σημείο «https://chatapi.viber.com» αντικαθίσταται από το «https://api.counterbat.com/» για χρήση με τη λειτουργία Counterbat.

Ξεκινήστε

Για να εφαρμόσετε το API, θα χρειαστείτε: 1. Ένας λογαριασμός Active Viber σε μια πλατφόρμα που υποστηρίζει bots (iOS/Android). 2. Ενεργό bot. 3. Διακριτικό ελέγχου ταυτότητας λογαριασμού. 4. Ρύθμιση webhook λογαριασμού.

Διακριτικό ελέγχου ταυτότητας

Κάθε αίτημα API πρέπει να περιλαμβάνει μια κεφαλίδα HTTP που ονομάζεται "X-Viber-Auth-Token" που περιέχει το διακριτικό ελέγχου ταυτότητας του λογαριασμού. 

X-Viber-Auth-Token: 445da6az1s345z78-dazcczb2542zv51a-e0vc5fva17480im9

Webhooks

Ρύθμιση Webhook

URL πόρου

https://api.counterbat.com/pa/set_webhook

Δημοσίευση δεδομένων

{
   "url": "https://my.host.com",
   "event_types": [
      "delivered",
      "seen",
      "failed",
      "subscribed",
      "unsubscribed",
      "conversation_started"
   ],
   "send_name": true,
   "send_photo": true
}

Αφαίρεση του webhook σας

Για να απενεργοποιήσετε το webhook, δημοσιεύστε ένα αίτημα «set_webhook» με μια κενή συμβολοσειρά URL. 

{
   "url": ""
}

Αποστολή μηνύματος

Το API send_message επιτρέπει στους λογαριασμούς να στέλνουν μηνύματα σε χρήστες του Viber που έχουν εγγραφεί στον λογαριασμό.

URL πόρου

https://api.counterbat.com/pa/send_message

Παράδειγμα απάντησης

{
   "status": 0,
   "status_message": "ok",
   "message_token": 5741311803571721087,
   "chat_hostname": "SN-CHAT-05_",
   "billing_status": 1
}

Πληκτρολόγια

Το API επιτρέπει την αποστολή ενός προσαρμοσμένου πληκτρολογίου χρησιμοποιώντας το API send_message για να παρέχει στον χρήστη ένα σύνολο προκαθορισμένων απαντήσεων ή ενεργειών.

URL πόρου

https://api.counterbat.com/pa/send_message

Μήνυμα εκπομπής

Το API broadcast_message επιτρέπει στους λογαριασμούς να στέλνουν μηνύματα σε πολλούς χρήστες του Viber που έχουν εγγραφεί στον λογαριασμό. Το μέγιστο μήκος λίστας είναι 300 δέκτες.

URL πόρου

https://api.counterbat.com/pa/broadcast_message

Λάβετε πληροφορίες λογαριασμού

Το αίτημα "get_account_info" θα λάβει τα στοιχεία του λογαριασμού όπως έχουν καταχωρηθεί.

URL πόρου

https://api.counterbat.com/pa/get_account_info

Λήψη στοιχείων χρήστη

Το αίτημα "get_user_details" θα λάβει τα στοιχεία ενός συγκεκριμένου χρήστη του Viber με βάση το μοναδικό αναγνωριστικό χρήστη του.

URL πόρου

https://api.counterbat.com/pa/get_user_details

Συνδεθείτε στο διαδίκτυο

Το αίτημα «get_online» θα λάβει την κατάσταση σύνδεσης ενός δεδομένου εγγεγραμμένου λογαριασμού (έως 100 αναγνωριστικά χρήστη ανά αίτημα).

URL πόρου

https://api.counterbat.com/pa/get_online

Επανακλήσεις

Το Viber προσφέρει επανάκληση για συμβάντα όπως "εγγραφή", "μη εγγραφή", "έναρξη_συνομιλίας", "παραδόθηκε", "προβλήθηκε", "αποτυχία" και "μήνυμα". Η επανάκληση θα αναρτηθεί στη διεύθυνση URL που παρέχεται κατά την κλήση «set_webhook».