Bază de cunoștințe

Zinn® Campaigns API și MCP: ghidul dezvoltatorului

Autentificare, permisiuni, exemple, limite, erori, webhookuri și fiecare operațiune a API-ului Zinn® Campaigns, inclusiv cele pe care un asistent AI le poate rula prin MCP.

Zinn®, vikingul nostru, citindu-și lista de verificare lângă un index de articole, cu unul deschis.

Tot ceea ce puteți face în Zinn® Campaigns din tabloul de bord puteți face și prin intermediul API-ului, iar cea mai mare parte și de la un asistent AI conectat la contul dumneavoastră prin MCP. Acest ghid acoperă conectarea, permisiunile, un exemplu practic în ambele moduri, limitele, erorile și fiecare dintre cele 89 de operațiuni Campaigns. Lista de operațiuni de mai jos este generată din specificația noastră API, astfel încât să corespundă întotdeauna cu ceea ce face API-ul. Fiecare câmp al fiecărei operațiuni se află în referința API de la zinndigital.com/developers/api/zinn-campaigns.

Conectare

  • Chei API. Creați o cheie în tabloul de bord la Setări → Chei API și trimiteți-o ca Authorization: Bearer zdk_live_… (o cheie zdk_test_… funcționează în modul sandbox). Acordați cheii doar permisiunile Campaigns necesare și nimic mai mult.
  • Asistenți AI (MCP). Conectați Claude, ChatGPT, Cursor sau orice client MCP la https://api.zinndigital.com/v1/mcp, fie conectându-vă din aplicație, fie cu un token de conexiune (zmcp_live_…). Consultați Conectarea Claude, Cursor sau ChatGPT la contul dumneavoastră. Pe ecranul de consimțământ, bifați permisiunile Zinn® Campaigns.
  • Permisiuni. email_marketing.view citește campanii, liste, contacte, formulare, expeditori, setări SMS și rapoarte; email_marketing.manage le creează și le modifică. Campaniile pe care le trimiteți prin propriul serviciu de e-mail utilizează campaigns.view și campaigns.manage.
  • Distribuitori. Transmiteți org_id pentru a acționa asupra uneia dintre organizațiile clienților dumneavoastră. Omiteți-l atunci când cheia sau conexiunea dumneavoastră accesează exact o singură organizație.

Exemplu: creați o schiță de campanie cu API-ul

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"
}'

Răspunsul este 201 împreună cu ciorna. Testați-o cu POST /v1/email-marketing/campaigns/{campaign_id}/test, verificați-o cu GET /v1/email-marketing/campaigns/{campaign_id}/lint și trimiteți-o cu POST /v1/email-marketing/campaigns/{campaign_id}/send.

Exemplu: aceeași ciornă de la un asistent AI

Adresați-vă asistentului dumneavoastră în cuvinte simple, de exemplu „creează o ciornă de e-mail Zinn® Campaigns numită Spring sale cu subiectul 'Our spring sale starts today'”. În culise, acesta găsește operațiunea cu api_operations_search, îi citește parametrii cu api_operation_get și o execută cu 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"
      }
    }
  }
}

Ce nu va face un asistent. Orice acțiune care trimite către destinatarii dumneavoastră sau consumă bani ori din limita disponibilă — trimiterea unei campanii, trimiterea de mesaje SMS sau WhatsApp, redactarea cu credite AI, înregistrarea pentru mesaje text în US — este refuzată unui asistent, astfel încât o instrucțiune înțeleasă greșit să nu poată ajunge niciodată la clienții dumneavoastră. Asistentul pregătește ciorna; dumneavoastră apăsați pe Trimitere în panoul de control sau apelați direct API-ul. De asemenea, secretele precum o parolă SMTP nu sunt transmise niciodată printr-un asistent: introduceți-le în panoul de control.

Limite

  • 1.200 de solicitări pe minut pentru fiecare persoană sau cheie API și 6.000 de solicitări pe minut pentru fiecare organizație. Se aplică limita mai strictă dintre cele două.
  • 600 de solicitări pe minut pentru fiecare conexiune MCP.
  • La depășirea unei limite, răspunsul este 429 cu un antet Retry-After: așteptați numărul respectiv de secunde.
  • Adăugarea membrilor în listă acceptă cel mult 1.000 de adrese per solicitare; limitele de contacte și de e-mailuri ale planului dumneavoastră se aplică la tot ceea ce efectuați prin intermediul API-ului.

Erori

Fiecare eroare are aceeași structură:

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

code nu se modifică niciodată pentru aceeași problemă, așadar testați-l pe acesta în loc de message. Menționați request_id atunci când contactați asistența. Răspunsurile pe care le veți întâlni: 401 UNAUTHORIZED, 403 FORBIDDEN, 404 NOT_FOUND, 409 CONFLICT, 422 UNPROCESSABLE_ENTITY, 429 TOO_MANY_REQUESTS. Un 403 înseamnă că cheia sau conexiunea nu are o permisiune specificată în lista de mai jos; un 404 acoperă, de asemenea, un element dintr-o organizație pe care nu îl puteți vedea; un 422 listează fiecare câmp greșit în details; după un 429, așteptați numărul de secunde din antetul Retry-After.

Webhook-uri

Rezultatele livrării sosesc în Zinn® Campaigns de la furnizorul care vă trimite e-mailul:

  • Cu propriul furnizor (de exemplu, Resend), stocați secretul de semnare a webhook-ului pe conexiunea de trimitere din tabloul de bord (Campanii → Trimitere). Primiți un webhook_url; direcționați evenimentele delivered, bounced și complained ale furnizorului către acesta. O respingere sau o plângere de spam elimină imediat adresa din trimiterile viitoare.
  • Cu trimiterea prin Zinn®, nu este nimic de configurat.

Citiți rezultatele cu operațiunile de raportare (getEmailMarketingCampaignReport, getSmsMarketingCampaignReport).

Fiecare operațiune Campaigns

Prezentare generală

  • GET /v1/email-marketing — Prezentare generală Zinn® Campaigns pentru o organizație. Operațiunea getEmailMarketingOverview. Permisiuni verificate: email_marketing.view. De la un asistent IA: da, prin MCP.

Campanii de e-mail

  • GET /v1/email-marketing/campaigns — Campanii de e-mail, cele mai recente mai întâi, o pagină keyset. Operațiune listEmailMarketingCampaigns. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/campaigns — Creați o ciornă de campanie de e-mail. Operațiune createEmailMarketingCampaign. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • GET /v1/email-marketing/campaigns/{campaign_id} — O campanie de e-mail. Operațiune getEmailMarketingCampaign. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • PATCH /v1/email-marketing/campaigns/{campaign_id} — Editați o ciornă (sau o campanie refuzată, care revine la starea de ciornă). Operațiune updateEmailMarketingCampaign. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • GET /v1/email-marketing/campaigns/{campaign_id}/lint — Verificați textul unei campanii pentru probleme de livrabilitate înainte de a fi trimisă. Operațiune lintEmailMarketingCampaign. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • GET /v1/email-marketing/campaigns/{campaign_id}/report — Cifrele unei campanii. Operațiune getEmailMarketingCampaignReport. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/campaigns/{campaign_id}/send — Începeți trimiterea unei campanii către lista acesteia. Operațiune sendEmailMarketingCampaign. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: doar prin API și tabloul de bord: consumă bani sau alocarea disponibilă, prin urmare este apăsat de o persoană (trimite către destinatari reali și consumă alocarea).
  • POST /v1/email-marketing/campaigns/{campaign_id}/test — Trimiteți acum o copie de test către un membru al organizației. Operațiune testEmailMarketingCampaign. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin intermediul MCP.
  • POST /v1/email-marketing/campaigns/{campaign_id}/translate — Traduceți o campanie în fiecare limbă de contact care lipsește sau este învechită. Operațiune translateEmailMarketingCampaign. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin intermediul MCP.
  • GET /v1/email-marketing/campaigns/{campaign_id}/translations — Fiecare limbă de contact a listei unei campanii și dacă traducerea acesteia este actualizată. Operațiune listEmailMarketingCampaignTranslations. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin intermediul MCP.

Redactare cu ajutorul AI

  • POST /v1/email-marketing/ai/write — Scrieți o ciornă de e-mail de campanie dintr-o scurtă descriere cu Zinn® AI. Operațiune writeEmailMarketingCampaignWithAi. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: doar API și panoul de control: consumă bani sau cotă, deci este apăsat de o persoană (scrierea cu AI consumă credite AI).

Kit de brand

  • GET /v1/email-marketing/brand-kit — Kitul de brand al organizației (nume, siglă, culori, font, voce). Operațiune getEmailMarketingBrandKit. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • PUT /v1/email-marketing/brand-kit — Editați kitul de brand. Operațiune updateEmailMarketingBrandKit. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/brand-kit/read — Citiți kitul de brand de pe site-ul web al organizației. Operațiune readEmailMarketingBrandKit. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.

Contacte și mesaje punctuale

  • GET /v1/email-marketing/contacts — Contactele organizației, câte o pagină keyset pe rând. Operațiunea listEmailMarketingContacts. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/contacts/{contact_id}/messages — Trimiteți un SMS către un contact, achitat din soldul de credite Zinn®. Operațiunea sendEmailMarketingMessage. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: doar prin API și tabloul de bord: implică cheltuieli de bani sau din alocare, astfel încât o persoană trebuie să îl apese (un mesaj individual către un contact consumă din alocare).
  • GET /v1/email-marketing/messages — Mesajele SMS și WhatsApp trimise de organizație, cele mai noi primele, o pagină keyset. Operațiunea listEmailMarketingMessages. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.

Liste

  • GET /v1/email-marketing/lists — Listele de corespondență ale organizației cu numărul de abonați / dezabonați. Operațiunea listEmailMarketingLists. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/lists — Creați o listă de corespondență (sau returnați-o pe cea cu acel nume). Operațiunea createEmailMarketingList. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/lists/{list_id}/members — Adăugați contacte la o listă prin adresa de e-mail (cel mult 1.000 pe solicitare). Operațiunea addEmailMarketingListMembers. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.

Importuri

  • GET /v1/email-marketing/imports — Importuri anterioare de contacte, cele mai recente mai întâi, câte o pagină keyset pe rând. Operațiunea listEmailMarketingImports. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/imports — Importați un set de contacte împreună cu atestarea consimțământului acestuia. Operațiunea createEmailMarketingImport. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.

Formulare de înscriere

  • GET /v1/email-marketing/forms — Formulare de înscriere (dublu opt-in), cele mai noi mai întâi, o pagină keyset. Operațiunea listEmailMarketingForms. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/forms — Creați un formular de înscriere care adaugă persoanele confirmate la o listă. Operațiunea createEmailMarketingForm. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • DELETE /v1/email-marketing/forms/{form_id} — Ștergeți un formular de înscriere (persoanele deja confirmate rămân în listă). Operațiunea deleteEmailMarketingForm. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • PATCH /v1/email-marketing/forms/{form_id} — Modificați un formular de înscriere (formulare, listă, redirecționare, activat sau dezactivat). Operațiunea updateEmailMarketingForm. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.

Conexiuni de trimitere

  • GET /v1/email-marketing/senders — Conexiunile de trimitere ale organizației. Operațiunea listEmailMarketingSenders. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin intermediul MCP.
  • POST /v1/email-marketing/senders — Conectați un expeditor de campanie (trimitere Zinn® sau serverul SMTP propriu al clientului). Operațiunea createEmailMarketingSender. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: doar prin API și panoul de control: transportă un secret care nu trebuie să ajungă niciodată la un model AI (corpul este parola SMTP).
  • DELETE /v1/email-marketing/senders/{sender_id} — Eliminați o conexiune de trimitere și parola stocată a acesteia. Operațiunea deleteEmailMarketingSender. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin intermediul MCP.
  • POST /v1/email-marketing/senders/{sender_id}/verify — Dovediți că o conexiune de trimitere funcționează, fără a trimite nimic. Operațiunea verifyEmailMarketingSender. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin intermediul MCP.
  • PUT /v1/email-marketing/senders/{sender_id}/webhook — Stocați secretul de semnare al webhook-ului furnizorului dumneavoastră de e-mail pentru această conexiune. Operațiunea setEmailMarketingSenderWebhook. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: apelat de un alt sistem (un furnizor sau un vizitator), nu de dumneavoastră (stochează secretul de webhook al unui furnizor).

SMS și WhatsApp

  • GET /v1/email-marketing/sms — Ce necesită ecranul SMS — deschis?, întrerupt?, sold de credite și prețuri. Operațiune getEmailMarketingSms. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • GET /v1/email-marketing/sms/campaigns — Campanii de SMS în masă, cele mai recente primele, o pagină de tip keyset. Operațiune listSmsMarketingCampaigns. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/sms/campaigns — Creați o ciornă de SMS pentru o listă. Operațiune createSmsMarketingCampaign. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • GET /v1/email-marketing/sms/campaigns/{campaign_id} — O campanie de SMS în masă. Operațiune getSmsMarketingCampaign. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — Editați o ciornă (sau o campanie refuzată, care revine la stadiul de ciornă). Operațiune updateSmsMarketingCampaign. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — Cifrele unei campanii de SMS în masă. Operațiune getSmsMarketingCampaignReport. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — Începeți trimiterea unui SMS către toate persoanele din listă care au acceptat să primească SMS — sau reluați o campanie întreruptă din lipsă de credit. Operațiune sendSmsMarketingCampaign. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: doar API și panou de control: implică cheltuieli de bani sau din cotă, așadar o persoană trebuie să apese butonul (trimite mesaje plătite prin SMS/WhatsApp).
  • GET /v1/email-marketing/sms/registrations/us — Înregistrarea US 10DLC a acestei organizații și costul acesteia. Operațiune getEmailMarketingUsRegistration. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin intermediul MCP.
  • POST /v1/email-marketing/sms/registrations/us — Trimiteți brandul și campania acestei organizații pentru US 10DLC (taxat la trimitere). Operațiune submitEmailMarketingUsRegistration. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: doar API și panou de control: implică cheltuieli de bani sau din cotă, așadar o persoană trebuie să apese butonul (înregistrarea US 10DLC implică taxe de operator).

Campanii prin intermediul propriului serviciu de e-mail (șabloane, segmente, suprimări)

  • GET /v1/campaigns — Campaniile organizației. Operațiune listCampaigns. De la un asistent AI: da, prin intermediul MCP.
  • POST /v1/campaigns — Creați o campanie dintr-un șablon și un public. Operațiune createCampaign. De la un asistent AI: da, prin intermediul MCP.
  • DELETE /v1/campaigns/esp — Deconectați contul de furnizor și eliminați cheia stocată a acestuia. Operațiunea disconnectEsp. De la un asistent AI: numai API și tabloul de bord: conține un secret care nu trebuie să ajungă niciodată la un model AI (distruge cheia ESP stocată).
  • GET /v1/campaigns/esp — Contul propriu de furnizor de e-mail al organizației. Operațiunea getEspConnection. De la un asistent AI: da, prin MCP.
  • POST /v1/campaigns/esp — Conectați un cont de furnizor de e-mail. Operațiunea connectEsp. De la un asistent AI: numai API și tabloul de bord: conține un secret care nu trebuie să ajungă niciodată la un model AI (corpul este cheia API ESP).
  • POST /v1/campaigns/esp/verify — Confirmați că respectivul cont de furnizor funcționează și citiți domeniile verificate ale acestuia. Operațiunea verifyEspConnection. De la un asistent AI: numai API și tabloul de bord: conține un secret care nu trebuie să ajungă niciodată la un model AI (reverifică o cheie ESP stocată).
  • POST /v1/campaigns/preview — Generați un Render pentru un șablon cu valori de exemplu. Operațiunea previewCampaignTemplate. De la un asistent AI: da, prin MCP.
  • GET /v1/campaigns/segments — Segmentele dumneavoastră de public salvate. Operațiunea listCampaignSegments. Permisiuni verificate: campaigns.view. De la un asistent AI: da, prin MCP.
  • POST /v1/campaigns/segments — Salvați un nou segment de public. Operațiunea createCampaignSegment. Permisiuni verificate: campaigns.manage. De la un asistent AI: da, prin MCP.
  • GET /v1/campaigns/segments/fields — Vocabularul filtrelor, listele sale de valori și etichetele magice. Operațiunea getCampaignSegmentFields. Permisiuni verificate: campaigns.view. De la un asistent AI: da, prin MCP.
  • POST /v1/campaigns/segments/preview — Câte persoane atinge acest lucru, cine sunt acestea și cine este exclus. Operațiunea previewCampaignSegment. Permisiuni verificate: campaigns.view. De la un asistent AI: da, prin MCP.
  • DELETE /v1/campaigns/segments/{segmentId} — Arhivați un segment. Operațiunea archiveCampaignSegment. Permisiuni verificate: campaigns.manage. De la un asistent AI: da, prin MCP.
  • GET /v1/campaigns/segments/{segmentId} — Un segment salvat. Operațiunea getCampaignSegment. Permisiuni verificate: campaigns.view. De la un asistent AI: da, prin MCP.
  • PATCH /v1/campaigns/segments/{segmentId} — Redenumiți un segment sau modificați-i filtrele. Operațiunea updateCampaignSegment. Permisiuni verificate: campaigns.manage. De la un asistent AI: da, prin MCP.
  • GET /v1/campaigns/suppressions — Adrese care nu trebuie să primească mesaje de marketing. Operațiunea listCampaignSuppressions. Permisiuni verificate: campaigns.view. De la un asistent AI: da, prin MCP.
  • POST /v1/campaigns/suppressions — Adăugați o adresă la lista de suprimare. Operațiunea createCampaignSuppression. Permisiuni verificate: campaigns.manage. De la un asistent AI: da, prin MCP.
  • GET /v1/campaigns/tags — Paleta de etichete magice pe care o oferă editorul de campanii. Operațiunea listCampaignTags. De la un asistent AI: da, prin MCP.
  • GET /v1/campaigns/templates — Șabloanele de campanie ale organizației. Operațiunea listCampaignTemplates. De la un asistent AI: da, prin MCP.
  • POST /v1/campaigns/templates — Creați un șablon de campanie. Operațiunea createCampaignTemplate. De la un asistent AI: da, prin MCP.
  • DELETE /v1/campaigns/templates/{templateId} — Arhivați un șablon și retrageți sursele de traducere ale acestuia. Operațiunea archiveCampaignTemplate. De la un asistent AI: da, prin MCP.
  • GET /v1/campaigns/templates/{templateId} — Un șablon de campanie. Operațiunea getCampaignTemplate. De la un asistent AI: da, prin MCP.
  • PUT /v1/campaigns/templates/{templateId} — Editați un șablon de campanie. Operațiunea updateCampaignTemplate. De la un asistent AI: da, prin MCP.
  • POST /v1/campaigns/unsubscribe — Părăsiți o listă de marketing. Nu este necesar un cont. Operațiunea unsubscribeFromCampaigns. De la un asistent AI: doar API și panou de control: conține un secret care nu trebuie să ajungă niciodată la un model AI (preia un token semnat de dezabonare al destinatarului).
  • DELETE /v1/campaigns/{campaignId} — Ștergeți o campanie și retrageți rândurile de livrare ale acesteia. Operațiunea deleteCampaign. De la un asistent AI: doar API și panou de control: necesită o permisiune care nu este oferită conexiunilor AI (ștergerea unei campanii ESP necesită campaigns.send).
  • GET /v1/campaigns/{campaignId} — O campanie și raportul său de livrare. Operațiunea getCampaign. De la un asistent AI: da, prin intermediul MCP.
  • POST /v1/campaigns/{campaignId}/control — Întrerupeți temporar, reluați sau anulați o trimitere în curs de desfășurare. Operațiunea controlCampaign. De la un asistent AI: doar API și panoul de control: consumă bani sau cotă alocată, astfel încât o persoană trebuie să apese butonul (întrerupe temporar/reia o trimitere activă).
  • POST /v1/campaigns/{campaignId}/send — Porniți trimiterea durabilă. Operațiunea sendCampaign. De la un asistent AI: doar API și panoul de control: consumă bani sau cotă alocată, astfel încât o persoană trebuie să apese butonul (trimite o campanie ESP către destinatari reali).
  • POST /v1/campaigns/{campaignId}/test — Trimiteți un mesaj real pe canalul pe care campania îl va utiliza efectiv. Operațiunea testSendCampaign. De la un asistent AI: doar API și panoul de control: necesită o permisiune care nu este oferită conexiunilor AI (o trimitere de test ESP necesită permisiunea campaigns.send).

Pagini publice și webhookuri primite

  • GET /v1/public/email-marketing/c/{token} — Contorul de clicuri. Înregistrează un clic per destinatar și redirecționează către linkul original. Operațiunea emailMarketingClick. De la un asistent AI: o pagină pe care destinatarii dumneavoastră o deschid dintr-un e-mail (redirecționarea de urmărire a clicurilor).
  • GET /v1/public/email-marketing/f/{public_id} — Pagina găzduită a unui formular de înscriere (fără autentificare). Operațiunea emailMarketingFormPage. De la un asistent AI: o pagină pe care destinatarii dumneavoastră o deschid dintr-un e-mail (pagina publică a formularului de înscriere).
  • POST /v1/public/email-marketing/f/{public_id} — Trimiteți un formular de înscriere (pagină găzduită, încorporare sau JSON). Operațiunea emailMarketingFormSubmit. De la un asistent AI: apelat de un alt sistem (un furnizor sau un vizitator), nu de dumneavoastră (un vizitator trimite un formular de înscriere).
  • GET /v1/public/email-marketing/fc — Pagina de confirmare dublă opt-in (fără autentificare). Operațiunea emailMarketingFormConfirmPage. De la un asistent AI: o pagină pe care destinatarii dumneavoastră o deschid dintr-un e-mail (pagina de confirmare dublă opt-in).
  • POST /v1/public/email-marketing/fc — Confirmați o înscriere (adaugă persoana în listă cu o înregistrare a consimțământului). Operațiunea emailMarketingFormConfirm. De la un asistent AI: apelat de un alt sistem (un furnizor sau un vizitator), nu de dumneavoastră (un vizitator confirmă un dublu opt-in).
  • GET /v1/public/email-marketing/o/{token} — Imaginea de urmărire a deschiderilor (un GIF 1x1). Contorizează o deschidere per destinatar. Operațiunea emailMarketingOpenPixel. De la un asistent AI: o pagină pe care destinatarii dumneavoastră o deschid dintr-un e-mail (pixelul de urmărire a deschiderilor).
  • GET /v1/public/email-marketing/u/{token} — Linkul de dezabonare din subsol (fără autentificare). Operațiunea emailMarketingUnsubscribePage. De la un asistent AI: o pagină pe care destinatarii dumneavoastră o deschid dintr-un e-mail (pagina de dezabonare).
  • POST /v1/public/email-marketing/u/{token} — Dezabonare printr-un singur clic conform RFC 8058 (și butonul „oprește totul” de pe pagină). Operațiunea emailMarketingUnsubscribeOneClick. De la un asistent AI: apelat de un alt sistem (un furnizor sau un vizitator), nu de dumneavoastră (dezabonare printr-un singur clic RFC 8058).
  • GET /v1/public/email-marketing/warmup-u/{token} — Linkul de dezabonare din e-mailul de încălzire a grupului de marketing (fără autentificare). Operațiunea emailMarketingWarmupUnsubscribePage. De la un asistent AI: o pagină pe care destinatarii dumneavoastră o deschid dintr-un e-mail (pagina de dezabonare de la încălzire).
  • POST /v1/public/email-marketing/warmup-u/{token} — Dezabonare printr-un singur clic conform RFC 8058 din e-mailul de încălzire. Operațiunea emailMarketingWarmupUnsubscribeOneClick. De la un asistent AI: apelat de un alt sistem (un furnizor sau un vizitator), nu de dumneavoastră (dezabonare de la încălzire printr-un singur clic).
  • POST /v1/webhooks/campaign-events — Preluați un eveniment de livrare semnat de la furnizorul de e-mail. Operațiunea receiveCampaignDeliveryWebhook. De la un asistent AI: apelat de un alt sistem (un furnizor sau un vizitator), nu de dumneavoastră (webhook de livrare ESP semnat).
  • POST /v1/webhooks/campaigns/telnyx — Răspunsuri SMS primite (STOP / START) de la furnizorul nostru de SMS. Operațiunea receiveCampaignsTelnyxInbound. De la un asistent AI: apelat de un alt sistem (un furnizor sau un vizitator), nu de dumneavoastră (webhook de intrare Telnyx semnat).
  • POST /v1/webhooks/email-marketing/{connection_id} — Evenimentele de livrare ale propriului furnizor de e-mail al unui client pentru o conexiune de trimitere. Operațiunea receiveEmailMarketingProviderWebhook. De la un asistent AI: apelat de un alt sistem (un furnizor sau un vizitator), nu de dumneavoastră (webhook semnat expeditor-furnizor).

Fluxuri

  • GET /v1/email-marketing/flows — Fluxuri de e-mail (bun venit, drip, o dată anuală), o pagină keyset. Operațiunea listEmailMarketingFlows. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/flows — Creați un flux (începe ca o ciornă). Operațiunea createEmailMarketingFlow. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • DELETE /v1/email-marketing/flows/{flow_id} — Ștergeți un flux și înscrierile acestuia (rulările trimise rămân, sub formă de campanii). Operațiunea deleteEmailMarketingFlow. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • GET /v1/email-marketing/flows/{flow_id} — Un flux cu pașii săi și raportul său (înscriși, în desfășurare, rulări și destinatari per pas). Operațiunea getEmailMarketingFlow. Permisiuni verificate: email_marketing.view. De la un asistent AI: da, prin MCP.
  • PATCH /v1/email-marketing/flows/{flow_id} — Modificați un flux; parametrul steps, dacă este furnizat, înlocuiește întreaga secvență. Operațiunea updateEmailMarketingFlow. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/flows/{flow_id}/activate — Activați un flux; sunt înscrise doar persoanele care se alătură listei de acum înainte. Operațiunea activateEmailMarketingFlow. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.
  • POST /v1/email-marketing/flows/{flow_id}/pause — Întrerupeți temporar un flux; pașii programați așteaptă și nicio persoană nouă nu primește e-mailuri până la reactivare. Operațiunea pauseEmailMarketingFlow. Permisiuni verificate: email_marketing.manage, email_marketing.view. De la un asistent AI: da, prin MCP.

Cele mai recente din blog

Ce am scris despre găzduire, SEO și administrarea site-urilor la scară largă.

SEO și link building din stratul de găzduire: Perspectiva unui operator în 2026

Cum influențează găzduirea indexarea și distribuția autorității legăturilor (link equity) în 2026: menținerea paginilor indexate, evaluarea domeniilor vechi înainte de a construi pe ele, construirea de linkuri fără amprentă (footprint) și o perspectivă onestă asupra a ceea ce infrastructura poate și nu poate face pentru SEO.

Citiți articolul →

Optimizarea WordPress pentru viteză și securitate: o listă de verificare pentru performanță și module

O listă practică de verificare pentru un WordPress rapid și securizat: stocarea în cache la nivel de server, o memorie cache de obiecte per site, puținele module care merită rulate, menținerea stivei la zi și paginile WooCommerce pe care nu trebuie să le includeți niciodată în cache.

Citiți articolul →

Cum să alegeți găzduirea web gestionată în 2026: Ghidul cumpărătorului

Ce diferențiază cu adevărat o găzduire administrată bună de o mașină ieftină cu panou de control — migrări, copii de rezervă, izolare, stocare în cache reală și scalare corectă — și cum să o evaluați înainte de a vă lua un angajament.

Citiți articolul →

Citiți blogul →

Încă întâmpinați dificultăți?

Asistența este inclusă în fiecare plan, biroul este deschis 24 ore pe zi și ne puteți scrie în oricare dintre cele 58 limbi ale noastre — vă răspundem în limba dumneavoastră.

Contactați asistența Toate articolele