Zinn® Campaigns API και MCP: οδηγός προγραμματιστή

Ό,τι μπορείτε να κάνετε στο Zinn® Campaigns από τον πίνακα ελέγχου, μπορείτε επίσης να το κάνετε μέσω του API, και το μεγαλύτερο μέρος αυτού από έναν βοηθό τεχνητής νοημοσύνης συνδεδεμένο με τον λογαριασμό σας μέσω MCP. Αυτός ο οδηγός καλύπτει τη σύνδεση, τα δικαιώματα, ένα αναλυτικό παράδειγμα και για τους δύο τρόπους, τα όρια, τα σφάλματα και καθεμία από τις 89 λειτουργίες του Campaigns. Η παρακάτω λίστα λειτουργιών δημιουργείται από τις προδιαγραφές του API μας, επομένως αντιστοιχεί πάντα απόλυτα σε όσα εκτελεί το API. Κάθε πεδίο κάθε λειτουργίας βρίσκεται στην τεκμηρίωση αναφοράς του API στη διεύθυνση zinndigital.com/developers/api/zinn-campaigns.

Σύνδεση

• Κλειδιά API. Δημιουργήστε ένα κλειδί στον πίνακα ελέγχου στην ενότητα Ρυθμίσεις → Κλειδιά API και στείλτε το ως Authorization: Bearer zdk_live_… (ένα κλειδί zdk_test_… λειτουργεί σε λειτουργία sandbox). Παραχωρήστε στο κλειδί τα δικαιώματα για τις Καμπάνιες που χρειάζεται και τίποτα παραπάνω.
• Βοηθοί τεχνητής νοημοσύνης (MCP). Συνδέστε το Claude, το ChatGPT, το Cursor ή οποιονδήποτε πελάτη MCP στο https://api.zinndigital.com/v1/mcp, είτε πραγματοποιώντας σύνδεση από την εφαρμογή είτε με ένα διακριτικό σύνδεσης (zmcp_live_…). Δείτε Σύνδεση του Claude, Cursor ή ChatGPT στον λογαριασμό σας. Στην οθόνη συγκατάθεσης, επιλέξτε τα δικαιώματα για το Zinn® Campaigns.
• Δικαιώματα. Το email_marketing.view διαβάζει καμπάνιες, λίστες, επαφές, φόρμες, αποστολείς, ρυθμίσεις SMS και αναφορές· το email_marketing.manage τα δημιουργεί και τα τροποποιεί. Οι καμπάνιες που στέλνετε μέσω της δικής σας υπηρεσίας email χρησιμοποιούν τα campaigns.view και campaigns.manage.
• Μεταπωλητές. Περάστε το org_id για να ενεργήσετε σε έναν από τους οργανισμούς των πελατών σας. Παραλείψτε το όταν το κλειδί ή η σύνδεσή σας αφορά ακριβώς έναν οργανισμό.

Παράδειγμα: δημιουργία ενός προσχεδίου καμπάνιας με το API

curl -X POST https://api.zinndigital.com/v1/email-marketing/campaigns \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring sale",
  "subject": "Our spring sale starts today",
  "list_id": "<list id>",
  "sender_id": "<sender id>",
  "template": "basic"
}'

Η απάντηση είναι 201 με το προσχέδιο. Δοκιμάστε το με το POST /v1/email-marketing/campaigns/{campaign_id}/test, ελέγξτε το με το GET /v1/email-marketing/campaigns/{campaign_id}/lint και στείλτε το με το POST /v1/email-marketing/campaigns/{campaign_id}/send.

Παράδειγμα: το ίδιο προσχέδιο από έναν βοηθό τεχνητής νοημοσύνης

Ζητήστε από τον βοηθό σας με απλά λόγια, για παράδειγμα «δημιούργησε ένα προσχέδιο email στο Zinn® Campaigns με όνομα Ανοιξιάτικες εκπτώσεις και θέμα 'Οι ανοιξιάτικες εκπτώσεις μας ξεκινούν σήμερα'». Στο παρασκήνιο εντοπίζει τη λειτουργία με το api_operations_search, διαβάζει τις παραμέτρους της με το api_operation_get και την εκτελεί με το api_operation_call:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "api_operation_call",
    "arguments": {
      "operation_id": "createEmailMarketingCampaign",
      "confirm": true,
      "body": {
        "name": "Spring sale",
        "subject": "Our spring sale starts today"
      }
    }
  }
}

Τι δεν θα κάνει ένας βοηθός. Οτιδήποτε στέλνει στους παραλήπτες σας ή δαπανά χρήματα ή όρια — αποστολή καμπάνιας, αποστολή μηνυμάτων SMS ή WhatsApp, συγγραφή με πιστώσεις AI, εγγραφή για μηνύματα US — απορρίπτεται για έναν βοηθό, έτσι ώστε μια παρερμηνευμένη εντολή να μην μπορεί ποτέ να φτάσει στους πελάτες σας. Ο βοηθός προετοιμάζει το προσχέδιο· εσείς πατάτε Αποστολή στον πίνακα ελέγχου ή καλείτε το API μόνοι σας. Μυστικά όπως ένας κωδικός πρόσβασης SMTP επίσης δεν μεταβιβάζονται ποτέ μέσω ενός βοηθού: εισαγάγετέ τα στον πίνακα ελέγχου.

Όρια

• 1.200 αιτήματα ανά λεπτό για κάθε άτομο ή κλειδί API, και 6.000 αιτήματα ανά λεπτό για κάθε οργανισμό. Ισχύει το αυστηρότερο από τα δύο.
• 600 αιτήματα ανά λεπτό για κάθε σύνδεση MCP.
• Πάνω από ένα όριο, η απάντηση είναι 429 με κεφαλίδα Retry-After: περιμένετε τόσα δευτερόλεπτα.
• Η προσθήκη μελών λίστας δέχεται το πολύ 1.000 διευθύνσεις ανά αίτημα· τα όρια επαφών και email του προγράμματός σας ισχύουν για ό,τι κάνετε μέσω του API.

Σφάλματα

Κάθε σφάλμα έχει την ίδια μορφή:

{"error": {"code": "UNPROCESSABLE_ENTITY", "message": "…", "details": [{"field": "subject", "code": "REQUIRED", "message": "…"}], "request_id": "…"}}

Το code δεν αλλάζει ποτέ για το ίδιο πρόβλημα, επομένως ελέγξτε αυτό αντί για το message. Αναφέρετε το request_id όταν επικοινωνείτε με την υποστήριξη. Οι απαντήσεις που θα συναντήσετε: 401 UNAUTHORIZED, 403 FORBIDDEN, 404 NOT_FOUND, 409 CONFLICT, 422 UNPROCESSABLE_ENTITY, 429 TOO_MANY_REQUESTS. Το 403 σημαίνει ότι το κλειδί ή η σύνδεση δεν διαθέτει κάποιο δικαίωμα που αναφέρεται στην παρακάτω λίστα· το 404 καλύπτει επίσης κάτι σε έναν οργανισμό που δεν μπορείτε να δείτε· το 422 παραθέτει κάθε εσφαλμένο πεδίο στο details· μετά από ένα 429, περιμένετε τον αριθμό δευτερολέπτων στην κεφαλίδα Retry-After.

Webhooks

Τα αποτελέσματα παράδοσης εισέρχονται στο Zinn® Campaigns από τον πάροχο που στέλνει το email σας:

• Με τον δικό σας πάροχο (για παράδειγμα, Resend), αποθηκεύστε το μυστικό υπογραφής webhook στη σύνδεση αποστολής στον πίνακα ελέγχου (Καμπάνιες → Αποστολή). Λαμβάνετε ένα webhook_url· κατευθύνετε σε αυτό τα συμβάντα παράδοσης, αναπήδησης και παραπόνων του παρόχου. Μια αναπήδηση ή ένα παράπονο για ανεπιθύμητη αλληλογραφία αφαιρεί αμέσως τη διεύθυνση από μελλοντικές αποστολές.
• Με την αποστολή Zinn®, δεν χρειάζεται να ρυθμίσετε τίποτα.

Διαβάστε τα αποτελέσματα με τις λειτουργίες αναφοράς (getEmailMarketingCampaignReport, getSmsMarketingCampaignReport).

Κάθε λειτουργία Campaigns

Επισκόπηση

• GET /v1/email-marketing — Επισκόπηση Zinn® Campaigns για έναν οργανισμό. Λειτουργία getEmailMarketingOverview. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.

Καμπάνιες email

• GET /v1/email-marketing/campaigns — Καμπάνιες ηλεκτρονικού ταχυδρομείου, οι νεότερες πρώτα, μία σελίδα keyset. Λειτουργία listEmailMarketingCampaigns. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• POST /v1/email-marketing/campaigns — Δημιουργία πρόχειρης καμπάνιας ηλεκτρονικού ταχυδρομείου. Λειτουργία createEmailMarketingCampaign. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• GET /v1/email-marketing/campaigns/{campaign_id} — Μία καμπάνια ηλεκτρονικού ταχυδρομείου. Λειτουργία getEmailMarketingCampaign. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• PATCH /v1/email-marketing/campaigns/{campaign_id} — Επεξεργασία πρόχειρου (ή απορριφθείσας καμπάνιας, η οποία επανέρχεται σε πρόχειρο). Λειτουργία updateEmailMarketingCampaign. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• GET /v1/email-marketing/campaigns/{campaign_id}/lint — Έλεγχος του κειμένου μιας καμπάνιας για προβλήματα παραδοσιμότητας πριν από την αποστολή της. Λειτουργία lintEmailMarketingCampaign. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• GET /v1/email-marketing/campaigns/{campaign_id}/report — Τα στατιστικά στοιχεία μιας καμπάνιας. Λειτουργία getEmailMarketingCampaignReport. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• POST /v1/email-marketing/campaigns/{campaign_id}/send — Έναρξη αποστολής μιας καμπάνιας στη λίστα της. Λειτουργία sendEmailMarketingCampaign. Ελεγχόμενα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: Μόνο μέσω API και πίνακα ελέγχου: καταναλώνει χρήματα ή υπόλοιπο, επομένως πρέπει να πατηθεί από άτομο (αποστέλλει σε πραγματικούς παραλήπτες και καταναλώνει υπόλοιπο).
• POST /v1/email-marketing/campaigns/{campaign_id}/test — Αποστολή ενός δοκιμαστικού αντιγράφου τώρα σε ένα μέλος του οργανισμού. Λειτουργία testEmailMarketingCampaign. Ελεγχόμενα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: Ναι, μέσω του MCP.
• POST /v1/email-marketing/campaigns/{campaign_id}/translate — Μετάφραση μιας καμπάνιας σε κάθε γλώσσα επαφής που λείπει ή δεν είναι ενημερωμένη. Λειτουργία translateEmailMarketingCampaign. Ελεγχόμενα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: Ναι, μέσω του MCP.
• GET /v1/email-marketing/campaigns/{campaign_id}/translations — Κάθε γλώσσα επαφής της λίστας μιας καμπάνιας και το αν η μετάφρασή της είναι ενημερωμένη. Λειτουργία listEmailMarketingCampaignTranslations. Ελεγχόμενα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: Ναι, μέσω του MCP.

Συγγραφή με τεχνητή νοημοσύνη

• POST /v1/email-marketing/ai/write — Συντάξτε ένα προσχέδιο email καμπάνιας από ένα σύντομο brief με το Zinn® AI. Λειτουργία writeEmailMarketingCampaignWithAi. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: Μόνο API και πίνακας ελέγχου: καταναλώνει χρήματα ή όριο χρήσης, επομένως το πατάει άτομο (η συγγραφή με AI καταναλώνει μονάδες AI).

Brand kit

• GET /v1/email-marketing/brand-kit — Το brand kit του οργανισμού (όνομα, λογότυπο, χρώματα, γραμματοσειρά, ύφος επικοινωνίας). Λειτουργία getEmailMarketingBrandKit. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• PUT /v1/email-marketing/brand-kit — Επεξεργαστείτε το brand kit. Λειτουργία updateEmailMarketingBrandKit. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/brand-kit/read — Διαβάστε το brand kit από τον ιστότοπο του οργανισμού. Λειτουργία readEmailMarketingBrandKit. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.

Επαφές και μεμονωμένα μηνύματα

• GET /v1/email-marketing/contacts — Οι επαφές του οργανισμού, μία σελίδα keyset τη φορά. Λειτουργία listEmailMarketingContacts. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/contacts/{contact_id}/messages — Αποστολή ενός SMS σε μία επαφή, με χρέωση από το υπόλοιπο μονάδων Zinn®. Λειτουργία sendEmailMarketingMessage. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: μόνο API και πίνακας ελέγχου: καταναλώνει χρήματα ή όριο χρήσης, επομένως απαιτείται πάτημα από άνθρωπο (ένα μεμονωμένο μήνυμα σε μια επαφή καταναλώνει όριο χρήσης).
• GET /v1/email-marketing/messages — Μηνύματα SMS και WhatsApp που απέστειλε ο οργανισμός, τα νεότερα πρώτα, μία σελίδα keyset. Λειτουργία listEmailMarketingMessages. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.

Λίστες

• GET /v1/email-marketing/lists — Οι λίστες αλληλογραφίας του οργανισμού με καταμετρήσεις εγγεγραμμένων / απεγγεγραμμένων. Λειτουργία listEmailMarketingLists. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• POST /v1/email-marketing/lists — Δημιουργία λίστας αλληλογραφίας (ή επιστροφή εκείνης με αυτό το όνομα). Λειτουργία createEmailMarketingList. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• POST /v1/email-marketing/lists/{list_id}/members — Προσθήκη επαφών σε μια λίστα μέσω διεύθυνσης ηλεκτρονικού ταχυδρομείου (το πολύ 1.000 ανά αίτημα). Λειτουργία addEmailMarketingListMembers. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.

Εισαγωγές

• GET /v1/email-marketing/imports — Προηγούμενες εισαγωγές επαφών, οι νεότερες πρώτα, μία σελίδα keyset τη φορά. Λειτουργία listEmailMarketingImports. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• POST /v1/email-marketing/imports — Εισαγωγή ενός τμήματος επαφών μαζί με τη βεβαίωση συγκατάθεσής του. Λειτουργία createEmailMarketingImport. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.

Φόρμες εγγραφής

• GET /v1/email-marketing/forms — Φόρμες εγγραφής (double opt-in), οι νεότερες πρώτα, μία σελίδα keyset. Λειτουργία listEmailMarketingForms. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/forms — Δημιουργήστε μια φόρμα εγγραφής που προσθέτει επιβεβαιωμένα άτομα σε μία λίστα. Λειτουργία createEmailMarketingForm. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• DELETE /v1/email-marketing/forms/{form_id} — Διαγράψτε μια φόρμα εγγραφής (τα άτομα που έχουν ήδη επιβεβαιωθεί παραμένουν στη λίστα). Λειτουργία deleteEmailMarketingForm. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• PATCH /v1/email-marketing/forms/{form_id} — Τροποποιήστε μια φόρμα εγγραφής (διατύπωση, λίστα, ανακατεύθυνση, ενεργοποίηση ή απενεργοποίηση). Λειτουργία updateEmailMarketingForm. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.

Συνδέσεις αποστολής

• GET /v1/email-marketing/senders — Οι συνδέσεις αποστολής του οργανισμού. Λειτουργία listEmailMarketingSenders. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/senders — Σύνδεση αποστολέα καμπάνιας (αποστολή Zinn® ή ο διακομιστής SMTP του ίδιου του πελάτη). Λειτουργία createEmailMarketingSender. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: μόνο API και πίνακας ελέγχου: μεταφέρει ένα μυστικό που δεν πρέπει ποτέ να φτάσει σε μοντέλο AI (το σώμα είναι ο κωδικός πρόσβασης SMTP).
• DELETE /v1/email-marketing/senders/{sender_id} — Κατάργηση μιας σύνδεσης αποστολής και του αποθηκευμένου κωδικού πρόσβασής της. Λειτουργία deleteEmailMarketingSender. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/senders/{sender_id}/verify — Επιβεβαίωση ότι μια σύνδεση αποστολής λειτουργεί, χωρίς αποστολή περιεχομένου. Λειτουργία verifyEmailMarketingSender. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• PUT /v1/email-marketing/senders/{sender_id}/webhook — Αποθήκευση του μυστικού υπογραφής webhook του παρόχου ηλεκτρονικού ταχυδρομείου σας για αυτήν τη σύνδεση. Λειτουργία setEmailMarketingSenderWebhook. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: καλείται από άλλο σύστημα (πάροχο ή επισκέπτη), όχι από εσάς (αποθηκεύει ένα μυστικό webhook παρόχου).

SMS και WhatsApp

• GET /v1/email-marketing/sms — Τι χρειάζεται η οθόνη SMS — ανοιχτό;, σε παύση;, υπόλοιπο μονάδων και τιμές. Λειτουργία getEmailMarketingSms. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/email-marketing/sms/campaigns — Μαζικές καμπάνιες SMS, νεότερες πρώτα, μία σελίδα keyset. Λειτουργία listSmsMarketingCampaigns. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/sms/campaigns — Δημιουργία πρόχειρου SMS προς μια λίστα. Λειτουργία createSmsMarketingCampaign. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/email-marketing/sms/campaigns/{campaign_id} — Μία μαζική καμπάνια SMS. Λειτουργία getSmsMarketingCampaign. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — Επεξεργασία προχείρου (ή απορριφθείσας καμπάνιας, η οποία επιστρέφει σε πρόχειρο). Λειτουργία updateSmsMarketingCampaign. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — Αριθμητικά στοιχεία μαζικής καμπάνιας SMS. Λειτουργία getSmsMarketingCampaignReport. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — Έναρξη αποστολής SMS σε όλους στη λίστα της που έχουν συμφωνήσει στη λήψη SMS — ή συνέχιση μιας εκστρατείας που έχει τεθεί σε παύση λόγω υπολοίπου. Λειτουργία sendSmsMarketingCampaign. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: Μόνο μέσω API και πίνακα ελέγχου: καταναλώνει χρήματα ή όριο χρήσης, επομένως πατιέται από άτομο (αποστέλλει πληρωμένα μηνύματα SMS/WhatsApp).
• GET /v1/email-marketing/sms/registrations/us — Η εγγραφή US 10DLC αυτού του οργανισμού, καθώς και το κόστος της. Λειτουργία getEmailMarketingUsRegistration. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: Ναι, μέσω του MCP.
• POST /v1/email-marketing/sms/registrations/us — Υποβολή της επωνυμίας και της εκστρατείας αυτού του οργανισμού για US 10DLC (χρέωση κατά την υποβολή). Λειτουργία submitEmailMarketingUsRegistration. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό τεχνητής νοημοσύνης: Μόνο μέσω API και πίνακα ελέγχου: καταναλώνει χρήματα ή όριο χρήσης, επομένως πατιέται από άτομο (η εγγραφή US 10DLC επιφέρει τέλη παρόχων τηλεπικοινωνιών).

Εκστρατείες μέσω της δικής σας υπηρεσίας ηλεκτρονικού ταχυδρομείου (πρότυπα, τμήματα, εξαιρέσεις)

• GET /v1/campaigns — Οι εκστρατείες του οργανισμού. Λειτουργία listCampaigns. Από βοηθό τεχνητής νοημοσύνης: Ναι, μέσω του MCP.
• POST /v1/campaigns — Δημιουργία εκστρατείας από ένα πρότυπο και ένα κοινό. Λειτουργία createCampaign. Από βοηθό τεχνητής νοημοσύνης: Ναι, μέσω του MCP.
• DELETE /v1/campaigns/esp — Αποσυνδέστε τον λογαριασμό παρόχου και καταργήστε το αποθηκευμένο κλειδί του. Λειτουργία disconnectEsp. Από βοηθό τεχνητής νοημοσύνης: Μόνο API και πίνακας ελέγχου: φέρει ένα μυστικό που δεν πρέπει ποτέ να φτάσει σε μοντέλο τεχνητής νοημοσύνης (καταστρέφει το αποθηκευμένο κλειδί ESP).
• GET /v1/campaigns/esp — Ο ιδιόκτητος λογαριασμός παρόχου ηλεκτρονικού ταχυδρομείου του οργανισμού. Λειτουργία getEspConnection. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• POST /v1/campaigns/esp — Συνδέστε έναν λογαριασμό παρόχου ηλεκτρονικού ταχυδρομείου. Λειτουργία connectEsp. Από βοηθό τεχνητής νοημοσύνης: Μόνο API και πίνακας ελέγχου: φέρει ένα μυστικό που δεν πρέπει ποτέ να φτάσει σε μοντέλο τεχνητής νοημοσύνης (το κύριο σώμα είναι το κλειδί API ESP).
• POST /v1/campaigns/esp/verify — Επιβεβαιώστε ότι ο λογαριασμός παρόχου λειτουργεί και διαβάστε τους επαληθευμένους τομείς του. Λειτουργία verifyEspConnection. Από βοηθό τεχνητής νοημοσύνης: Μόνο API και πίνακας ελέγχου: φέρει ένα μυστικό που δεν πρέπει ποτέ να φτάσει σε μοντέλο τεχνητής νοημοσύνης (επανελέγχει ένα αποθηκευμένο κλειδί ESP).
• POST /v1/campaigns/preview — Render ένα πρότυπο με παραδείγματα τιμών. Λειτουργία previewCampaignTemplate. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• GET /v1/campaigns/segments — Τα αποθηκευμένα τμήματα κοινού σας. Λειτουργία listCampaignSegments. Ελεγμένα δικαιώματα: campaigns.view. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• POST /v1/campaigns/segments — Αποθηκεύστε ένα νέο τμήμα κοινού. Λειτουργία createCampaignSegment. Ελεγμένα δικαιώματα: campaigns.manage. Από βοηθό τεχνητής νοημοσύνης: ναι, μέσω του MCP.
• GET /v1/campaigns/segments/fields — Το λεξιλόγιο φίλτρων, οι λίστες τιμών του και οι μαγικές ετικέτες. Λειτουργία getCampaignSegmentFields. Ελεγχόμενα δικαιώματα: campaigns.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/campaigns/segments/preview — Πόσα άτομα προσεγγίζει αυτό, ποιοι είναι και ποιους εξαιρεί. Λειτουργία previewCampaignSegment. Ελεγχόμενα δικαιώματα: campaigns.view. Από βοηθό AI: ναι, μέσω του MCP.
• DELETE /v1/campaigns/segments/{segmentId} — Αρχειοθέτηση ενός τμήματος. Λειτουργία archiveCampaignSegment. Ελεγχόμενα δικαιώματα: campaigns.manage. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/campaigns/segments/{segmentId} — Ένα αποθηκευμένο τμήμα. Λειτουργία getCampaignSegment. Ελεγχόμενα δικαιώματα: campaigns.view. Από βοηθό AI: ναι, μέσω του MCP.
• PATCH /v1/campaigns/segments/{segmentId} — Μετονομασία ενός τμήματος ή αλλαγή των φίλτρων του. Λειτουργία updateCampaignSegment. Ελεγχόμενα δικαιώματα: campaigns.manage. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/campaigns/suppressions — Διευθύνσεις που δεν πρέπει να λαμβάνουν μάρκετινγκ. Λειτουργία listCampaignSuppressions. Ελεγχόμενα δικαιώματα: campaigns.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/campaigns/suppressions — Προσθήκη μιας διεύθυνσης στη λίστα αποκλεισμού. Λειτουργία createCampaignSuppression. Ελεγχόμενα δικαιώματα: campaigns.manage. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/campaigns/tags — Η παλέτα magic-tag που προσφέρει ένας συντάκτης εκστρατείας. Λειτουργία listCampaignTags. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/campaigns/templates — Τα πρότυπα εκστρατειών του οργανισμού. Λειτουργία listCampaignTemplates. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/campaigns/templates — Δημιουργία προτύπου εκστρατείας. Λειτουργία createCampaignTemplate. Από βοηθό AI: ναι, μέσω του MCP.
• DELETE /v1/campaigns/templates/{templateId} — Αρχειοθέτηση προτύπου και απόσυρση των πηγών μετάφρασής του. Λειτουργία archiveCampaignTemplate. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/campaigns/templates/{templateId} — Ένα πρότυπο εκστρατείας. Λειτουργία getCampaignTemplate. Από βοηθό AI: ναι, μέσω του MCP.
• PUT /v1/campaigns/templates/{templateId} — Επεξεργασία προτύπου εκστρατείας. Λειτουργία updateCampaignTemplate. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/campaigns/unsubscribe — Αποχώρηση από λίστα μάρκετινγκ. Δεν απαιτείται λογαριασμός. Λειτουργία unsubscribeFromCampaigns. Από βοηθό AI: μόνο μέσω API και πίνακα ελέγχου: περιέχει ένα μυστικό που δεν πρέπει ποτέ να φτάσει σε μοντέλο AI (δέχεται υπογεγραμμένο διακριτικό απεγγραφής παραλήπτη).
• DELETE /v1/campaigns/{campaignId} — Διαγραφή εκστρατείας και απόσυρση των γραμμών παράδοσής της. Λειτουργία deleteCampaign. Από βοηθό AI: μόνο μέσω API και πίνακα ελέγχου: απαιτεί δικαίωμα που δεν παρέχεται σε συνδέσεις AI (η διαγραφή εκστρατείας ESP απαιτεί campaigns.send).
• GET /v1/campaigns/{campaignId} — Μία καμπάνια και η αναφορά παράδοσής της. Λειτουργία getCampaign. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/campaigns/{campaignId}/control — Παύση, συνέχιση ή ακύρωση μιας ενεργής αποστολής. Λειτουργία controlCampaign. Από βοηθό AI: μόνο μέσω API και πίνακα ελέγχου: καταναλώνει χρήματα ή όριο χρήσης, επομένως πατιέται από άτομο (θέτει σε παύση/συνεχίζει μια ζωντανή αποστολή).
• POST /v1/campaigns/{campaignId}/send — Έναρξη της οριστικής αποστολής. Λειτουργία sendCampaign. Από βοηθό AI: μόνο μέσω API και πίνακα ελέγχου: καταναλώνει χρήματα ή όριο χρήσης, επομένως πατιέται από άτομο (αποστέλλει μια καμπάνια ESP σε πραγματικούς παραλήπτες).
• POST /v1/campaigns/{campaignId}/test — Αποστολή ενός πραγματικού μηνύματος στο κανάλι που θα χρησιμοποιήσει πραγματικά η καμπάνια. Λειτουργία testSendCampaign. Από βοηθό AI: μόνο μέσω API και πίνακα ελέγχου: απαιτεί δικαίωμα που δεν προσφέρεται σε συνδέσεις AI (μια δοκιμαστική αποστολή ESP απαιτεί campaigns.send).

Δημόσιες σελίδες και εισερχόμενα webhooks

• GET /v1/public/email-marketing/c/{token} — Ο μετρητής κλικ. Καταγράφει ένα κλικ ανά παραλήπτη και ανακατευθύνει στον αρχικό σύνδεσμο. Λειτουργία emailMarketingClick. Από βοηθό AI: μια σελίδα που ανοίγουν οι παραλήπτες σας από ένα email (η ανακατεύθυνση παρακολούθησης κλικ).
• GET /v1/public/email-marketing/f/{public_id} — Μια φιλοξενούμενη σελίδα φόρμας εγγραφής (χωρίς σύνδεση). Λειτουργία emailMarketingFormPage. Από βοηθό AI: μια σελίδα που ανοίγουν οι παραλήπτες σας από ένα email (η δημόσια σελίδα φόρμας εγγραφής).
• POST /v1/public/email-marketing/f/{public_id} — Υποβολή φόρμας εγγραφής (φιλοξενούμενη σελίδα, ενσωμάτωση ή JSON). Λειτουργία emailMarketingFormSubmit. Από έναν βοηθό τεχνητής νοημοσύνης: καλείται από άλλο σύστημα (έναν πάροχο ή έναν επισκέπτη), όχι από εσάς (ένας επισκέπτης υποβάλλει μια φόρμα εγγραφής).
• GET /v1/public/email-marketing/fc — Η σελίδα επιβεβαίωσης διπλής συναίνεσης (double opt-in) (χωρίς σύνδεση). Λειτουργία emailMarketingFormConfirmPage. Από έναν βοηθό τεχνητής νοημοσύνης: μια σελίδα που ανοίγουν οι παραλήπτες σας από ένα μήνυμα ηλεκτρονικού ταχυδρομείου (η σελίδα επιβεβαίωσης διπλής συναίνεσης).
• POST /v1/public/email-marketing/fc — Επιβεβαίωση εγγραφής (προσθέτει το άτομο στη λίστα με αρχείο συναίνεσης). Λειτουργία emailMarketingFormConfirm. Από έναν βοηθό τεχνητής νοημοσύνης: καλείται από άλλο σύστημα (έναν πάροχο ή έναν επισκέπτη), όχι από εσάς (ένας επισκέπτης επιβεβαιώνει μια διπλή συναίνεση).
• GET /v1/public/email-marketing/o/{token} — Η εικόνα παρακολούθησης ανοίγματος (ένα GIF 1x1). Καταμετρά ένα άνοιγμα ανά παραλήπτη. Λειτουργία emailMarketingOpenPixel. Από έναν βοηθό τεχνητής νοημοσύνης: μια σελίδα που ανοίγουν οι παραλήπτες σας από ένα μήνυμα ηλεκτρονικού ταχυδρομείου (το pixel παρακολούθησης ανοίγματος).
• GET /v1/public/email-marketing/u/{token} — Ο σύνδεσμος απεγγραφής στο υποσέλιδο (χωρίς σύνδεση). Λειτουργία emailMarketingUnsubscribePage. Από έναν βοηθό τεχνητής νοημοσύνης: μια σελίδα που ανοίγουν οι παραλήπτες σας από ένα μήνυμα ηλεκτρονικού ταχυδρομείου (η σελίδα απεγγραφής).
• POST /v1/public/email-marketing/u/{token} — Απεγγραφή με ένα κλικ κατά το RFC 8058 (και το κουμπί της σελίδας «διακοπή όλων»). Λειτουργία emailMarketingUnsubscribeOneClick. Από βοηθό τεχνητής νοημοσύνης: καλείται από άλλο σύστημα (έναν πάροχο ή έναν επισκέπτη), όχι από εσάς (απεγγραφή με ένα κλικ κατά το RFC 8058).
• GET /v1/public/email-marketing/warmup-u/{token} — Ο σύνδεσμος απεγγραφής του μηνύματος προθέρμανσης συγκέντρωσης μάρκετινγκ (χωρίς σύνδεση). Λειτουργία emailMarketingWarmupUnsubscribePage. Από βοηθό τεχνητής νοημοσύνης: μια σελίδα που ανοίγουν οι παραλήπτες σας από ένα μήνυμα ηλεκτρονικού ταχυδρομείου (η σελίδα απεγγραφής προθέρμανσης).
• POST /v1/public/email-marketing/warmup-u/{token} — Απεγγραφή με ένα κλικ κατά το RFC 8058 από το μήνυμα προθέρμανσης. Λειτουργία emailMarketingWarmupUnsubscribeOneClick. Από βοηθό τεχνητής νοημοσύνης: καλείται από άλλο σύστημα (έναν πάροχο ή έναν επισκέπτη), όχι από εσάς (απεγγραφή προθέρμανσης με ένα κλικ).
• POST /v1/webhooks/campaign-events — Εισαγωγή ενός υπογεγραμμένου συμβάντος παράδοσης από τον πάροχο ηλεκτρονικού ταχυδρομείου. Λειτουργία receiveCampaignDeliveryWebhook. Από βοηθό τεχνητής νοημοσύνης: καλείται από άλλο σύστημα (έναν πάροχο ή έναν επισκέπτη), όχι από εσάς (υπογεγραμμένο webhook παράδοσης ESP).
• POST /v1/webhooks/campaigns/telnyx — Εισερχόμενες απαντήσεις SMS (STOP / START) από τον πάροχο SMS μας. Λειτουργία receiveCampaignsTelnyxInbound. Από βοηθό τεχνητής νοημοσύνης: καλείται από άλλο σύστημα (έναν πάροχο ή έναν επισκέπτη), όχι από εσάς (υπογεγραμμένο εισερχόμενο webhook της Telnyx).
• POST /v1/webhooks/email-marketing/{connection_id} — Συμβάντα παράδοσης του παρόχου email του ίδιου του πελάτη για μία σύνδεση αποστολής. Λειτουργία receiveEmailMarketingProviderWebhook. Από βοηθό AI: καλείται από άλλο σύστημα (πάροχο ή επισκέπτη), όχι από εσάς (υπογεγραμμένο webhook παρόχου αποστολέα).

Ροές

• GET /v1/email-marketing/flows — Ροές email (καλωσορίσματος, drip, ετήσιας ημερομηνίας), μία σελίδα keyset. Λειτουργία listEmailMarketingFlows. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/flows — Δημιουργία ροής (ξεκινά ως προσχέδιο). Λειτουργία createEmailMarketingFlow. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• DELETE /v1/email-marketing/flows/{flow_id} — Διαγραφή ροής και των εγγραφών της (οι απεσταλμένες εκτελέσεις της παραμένουν ως καμπάνιες). Λειτουργία deleteEmailMarketingFlow. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• GET /v1/email-marketing/flows/{flow_id} — Μία ροή με τα βήματά της και την αναφορά της (εγγεγραμμένοι, σε εξέλιξη, εκτελέσεις και παραλήπτες ανά βήμα). Λειτουργία getEmailMarketingFlow. Ελεγμένα δικαιώματα: email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• PATCH /v1/email-marketing/flows/{flow_id} — Αλλαγή μιας ροής· το steps, όταν παρέχεται, αντικαθιστά ολόκληρη την ακολουθία. Λειτουργία updateEmailMarketingFlow. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/flows/{flow_id}/activate — Ενεργοποίηση μιας ροής· εγγράφονται μόνο τα άτομα που συνδέονται στη λίστα από εδώ και στο εξής. Λειτουργία activateEmailMarketingFlow. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.
• POST /v1/email-marketing/flows/{flow_id}/pause — Παύση μιας ροής· τα εκκρεμή βήματα περιμένουν και δεν αποστέλλεται email σε κανένα νέο άτομο μέχρι να ενεργοποιηθεί ξανά. Λειτουργία pauseEmailMarketingFlow. Ελεγμένα δικαιώματα: email_marketing.manage, email_marketing.view. Από βοηθό AI: ναι, μέσω του MCP.