ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

API για social media πολλών πελατών: ένα API key, οι λογαριασμοί όλων των πελατών σας

Το Partner API της easyCoexistence είναι πολλαπλών πελατών εκ σχεδιασμού: ένα κλειδί ec_live_ στον λογαριασμό σας συνδέει και διαχειρίζεται τους αριθμούς WhatsApp και τους λογαριασμούς social πολλών πελατών σας. Κάθε σύνδεση φέρει το id του πελάτη σας ως external_ref, έχει το δικό του token του πελάτη, έχει τον δικό της προορισμό webhook και εμφανίζεται στα υπογεγραμμένα events κατάστασης, οπότε το GET /channels?external_ref= εμφανίζει τους λογαριασμούς ενός πελάτη.

200 characters

Το μέγιστο μήκος external_ref που δέχεται μια συνεδρία σύνδεσης: το δικό σας id για τον πελάτη, αποθηκευμένο στη σύνδεση που δημιουργεί.

1 key

Τα κλειδιά API που μπορεί να έχει ταυτόχρονα ένας λογαριασμός easyCoexistence· ξεχωριστά κλειδιά σημαίνουν ξεχωριστούς λογαριασμούς με ξεχωριστές χρεώσεις.

50 open

Οι συνεδρίες σύνδεσης που μπορεί να είναι ανοιχτές ταυτόχρονα σε έναν λογαριασμό, με όριο 100 νέων συνεδριών την ώρα.

5 minutes

Η ηλικία μετά την οποία απορρίπτεται η χρονοσφραγίδα ενός υπογεγραμμένου event, με το HMAC να συγκρίνεται σε σταθερό χρόνο.

Πώς ένας λογαριασμός εξυπηρετεί πολλούς πελάτες;

Ο λογαριασμός σας easyCoexistence αντιπροσωπεύει το προϊόν σας, και κάθε πελάτης είναι μια ετικέτα στις συνδέσεις που φέρνει. Οι πελάτες δεν δημιουργούν λογαριασμό δικό τους, δεν βλέπουν ποτέ το κλειδί σας και τους χρεώνετε εσείς, όχι η easyCoexistence:

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

Πώς ετικετάρετε κάθε σύνδεση με τον πελάτη σας;

Στείλτε το external_ref στη συνεδρία σύνδεσης. Η τιμή αποθηκεύεται στον αριθμό ή στο κανάλι που δημιουργεί η συνεδρία, προστίθεται στην ανακατεύθυνση και περιλαμβάνεται στα events κατάστασής της. Μια είσοδος με Facebook ή LinkedIn που φέρνει πολλές σελίδες ετικετάρει την καθεμία. Για να δείτε τους λογαριασμούς ενός πελάτη, φιλτράρετε οποιαδήποτε από τις δύο λίστες:

One customer's social accounts and numbers
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

Πώς κρατιούνται χωριστά τα tokens των πελατών;

Κάθε σύνδεση κρατά το δικό της token του πελάτη. Το token ενός αριθμού WhatsApp είναι το business token που εκδίδει η Meta στο Embedded Signup, περιορισμένο στα στοιχεία αυτού του πελάτη, ενώ το token ενός λογαριασμού social είναι αυτό που χορήγησε ο κάτοχός του. Τα διαπιστευτήρια δίνονται μόνο μέσω του κλειδιού σας, από το backend σας, και ένα ID που δεν βρίσκεται στον λογαριασμό σας απαντά 404 not_found. Αναζητήστε τη σύνδεση του πελάτη στον οποίο ανήκει μια εργασία προτού ανακτήσετε το token της, ώστε η δουλειά ενός πελάτη να μην τρέχει ποτέ στον λογαριασμό άλλου.

Πώς λειτουργούν τα webhooks ανά πελάτη;

Ένας προορισμός ανά λογαριασμό, που επιλέγετε εσείς. Ορίστε τα κανάλια να δείχνουν σε ένα URL και δρομολογήστε με βάση το account_id στο σώμα, ή δώστε σε κάθε πελάτη δικό του URL. Κάθε κανάλι υπογράφει με δικό του μυστικό, που ορίζεται από το PUT /channels/{id}/webhook, οπότε το account_id σας λέει με ποιο μυστικό να επαληθεύσετε. Τα μηνύματα ενός αριθμού πηγαίνουν από τη Meta στο webhook_url του, που ορίζεται στον λογαριασμό WhatsApp Business, γι' αυτό δρομολογήστε τα με βάση το phone_number_id.

Πώς τα status events δηλώνουν σε ποιον πελάτη αφορούν;

Με το external_ref σας που μεταφέρουν. Ένα URL events ανά λογαριασμό λαμβάνει τα events connection.* και channel.*, καθένα με την προβολή της σύνδεσης ή του καναλιού μέσα του, με το external_ref συμπεριλαμβανόμενο, ενώ τα post.published και post.failed φέρουν την ανάρτηση και το κανάλι της. Τα events υπογράφονται με το δικό του μυστικό του λογαριασμού στο X-EC-Signature και ξαναστέλνονται όταν αποτυγχάνει το endpoint σας, γι' αυτό επεξεργαστείτε κάθε delivery id μία φορά.

Πόσο γρήγορα μπορείτε να εντάξετε πολλούς πελάτες;

Με 50 ανοιχτές συνεδρίες σύνδεσης και 100 νέες την ώρα ανά λογαριασμό. Η Meta μετρά κάθε πρώτη ένταξη WhatsApp σε ένα όριο για όλη την εφαρμογή, που μοιράζονται όλοι οι λογαριασμοί easyCoexistence, και τα όρια εμποδίζουν την εισαγωγή μιας πλατφόρμας να το εξαντλήσει. Δημιουργήστε κάθε συνεδρία όταν ο πελάτης της είναι έτοιμος να συνδεθεί, και ένα όριο απαντά 429 cap_reached ή rate_limited.

Τι γίνεται αν ο λογαριασμός ενός πελάτη είναι ήδη συνδεδεμένος αλλού;

Η είσοδος απορρίπτεται. Ένας λογαριασμός social συνδέεται μέσω ενός λογαριασμού easyCoexistence τη φορά, οπότε αν άλλη υπηρεσία που χρησιμοποιεί το easyCoexistence τον κρατά, το last_error της συνεδρίας το λέει, και ο πελάτης τον αφαιρεί εκεί ή συνδέεται με άλλον λογαριασμό. Μέσα στον δικό σας λογαριασμό, ένας πελάτης μπορεί να συνδέσει όσους λογαριασμούς χρειάζεται, καθένας με το ίδιο external_ref.

Πώς αποχωρεί ένας πελάτης;

Καταγράψτε τις συνδέσεις και τα κανάλια του με βάση το external_ref και κάντε DELETE σε καθένα. Η αφαίρεση ενός αριθμού ανακαλεί την πρόσβαση της easyCoexistence στη Meta και σταματά την παρακολούθηση· η αφαίρεση ενός καναλιού ανακαλεί την πρόσβαση στο δίκτυο και ακυρώνει τις αναρτήσεις του που περιμένουν ακόμα στην ουρά. Η χρέωση για καθεμία σταματά στο τέλος του κύκλου, και οι άλλες συνδέσεις του πελάτη, όπως και των άλλων πελατών σας, μένουν ανέπαφες.

Συνηθισμένα λάθη

  • Η χρήση email ως external_ref. Τα email αλλάζουν και η τιμή αποθηκεύεται σε κάθε σύνδεση, οπότε χρησιμοποιήστε το σταθερό id από τη δική σας βάση δεδομένων.
  • Η επαλήθευση των προωθημένων events με το μυστικό λάθος πελάτη. Αναζητήστε το μυστικό με βάση το account_id στο σώμα, αφού κάθε κανάλι υπογράφει με το δικό του.
  • Η αποστολή συνδέσμων σύνδεσης σε όλη τη βάση πελατών μαζί. Μόνο 50 συνεδρίες μπορούν να είναι ανοιχτές ανά λογαριασμό, γι' αυτό προσκαλέστε τους πελάτες σε κύματα.
  • Η διαγραφή ενός πελάτη μόνο στη δική σας βάση δεδομένων. Οι συνδέσεις του μένουν στον λογαριασμό σας και στη χρέωσή σας, έως ότου αφαιρεθεί η καθεμία μέσω του API.
Κάντε το με EasyCoexistence

Η easyCoexistence επιτρέπει σε ένα API key να εξυπηρετεί ολόκληρη τη βάση πελατών σας: τους αριθμούς WhatsApp τους και τους λογαριασμούς Instagram, Facebook, TikTok, YouTube και LinkedIn, καθώς και περισσότερα κανάλια, καθένα με το id του πελάτη σας ως ετικέτα, με δικό του token, webhook και υπογεγραμμένα events, και κάθε σύνδεση παρακολουθείται 24/7. Από US$ 9 μέχρι US$ 0.75 ανά σύνδεση τον μήνα, με πτώση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Χρειάζομαι έναν λογαριασμό easyCoexistence για κάθε πελάτη;

Όχι. Ένας λογαριασμός και το κλειδί του μπορούν να κρατούν τις συνδέσεις πολλών πελατών, που ξεχωρίζουν με το external_ref. Χωριστοί λογαριασμοί χρειάζονται μόνο όταν θέλετε χωριστές χρεώσεις.

Μπορούν οι πελάτες μου να βλέπουν τους λογαριασμούς ο ένας του άλλου;

Όχι μέσω της easyCoexistence. Δεν κατέχουν ποτέ το κλειδί σας και ανοίγουν μόνο τους δικούς τους συνδέσμους σύνδεσης. Τι βλέπει κάθε πελάτης μέσα στο προϊόν σας το αποφασίζει ο κώδικάς σας.

Μπορώ να δώσω σε κάθε πελάτη διαφορετικό URL webhook;

Ναι. Κάθε αριθμός και κάθε κανάλι δέχεται τον δικό του προορισμό, οπότε λειτουργεί ένα URL για συγκεκριμένο πελάτη, όπως και ένα κοινό URL που δρομολογείται με βάση το account_id.

Πώς χρεώνεται ένας λογαριασμός πολλών πελατών;

Ανά σύνδεση, σε όλους τους πελάτες σας μαζί: από US$ 9 μέχρι US$ 0.75 ανά σύνδεση τον μήνα, ανάλογα με τη βαθμίδα του συνολικού σας αριθμού, με τις πρώτες 3 ημέρες δωρεάν.

Συνεχίστε την ανάγνωση

API social media για SaaS με τη δική σας επωνυμία: προσθέστε δημοσιεύσεις, σχόλια και DMs στο προϊόν σαςΠροσθέστε δημοσιεύσεις, απαντήσεις σε σχόλια και DMs στο SaaS σας: τι βλέπουν οι πελάτες, πού φαίνεται το όνομα easyCoexistence και ποιες κλήσεις API χρειάζεστε.Πώς να επιτρέψετε στους πελάτες σας να συνδέσουν το Instagram στην εφαρμογή σαςΣύνδεση λογαριασμών Instagram πελατών μέσω σελίδας σύνδεσης: η κλήση συνεδρίας, το token και πώς η εφαρμογή σας δημοσιεύει και απαντά σε σχόλια και DM.Πώς να προσθέσετε το WhatsApp στο SaaS σας με Embedded Signup και CoexistenceΠροσθέστε το WhatsApp στο SaaS σας με Embedded Signup και Coexistence: συνδέστε αριθμούς πελατών, λάβετε μηνύματα, στείλτε templates.Ταυτοποίηση Partner API: κλειδιά Bearer ec_live_, εναλλαγή και σφάλματα 401Πώς ταυτοποιούνται τα αιτήματα Partner API: ένα κλειδί ec_live_ ανά λογαριασμό, που εμφανίζεται μία φορά και αντικαθίσταται αμέσως.Πώς να μάθετε πότε αποσυνδέεται η σύνδεση WhatsApp ή social ενός πελάτη;Γεγονότα connection.* και channel.*: payloads, αιτίες όπως PRIMARY_INACTIVITY, X-EC-Signature, επαναλήψεις για περίπου 33 ώρες και έλεγχος διπλών με το id.Πώς να επιτρέψετε στους χρήστες σας να συνδέσουν λογαριασμούς WhatsApp, Instagram και TikTok στην εφαρμογή σαςΦιλοξενούμενοι σύνδεσμοι για αριθμούς WhatsApp και λογαριασμούς κοινωνικών δικτύων: αίτημα, ανακατεύθυνση, κατάσταση, λήξη και επαναδοκιμές.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις