# Conekto Marketing

> Email, SMS, WhatsApp și web push pentru magazinele online din România: campanii, automatizări, formulare, segmente și rapoarte, legate de comenzi și de livrare.

## Documentație

- [Toată documentația pentru dezvoltatori, Markdown](https://marketing.conekto.app/dezvoltatori.md): API, script, webhooks, feed-uri, mediu de test
- [Primii pași](https://marketing.conekto.app/dezvoltatori#incepe): API-ul primește datele magazinului tău (clienți, produse, comenzi, evenimente) din orice platformă. Shopify și WooCommerce sunt conectate automat; restul folosesc API-ul de mai jos.
- [Autentificare și limite](https://marketing.conekto.app/dezvoltatori#autentificare): Fiecare cerere are antetul Authorization cu cheia magazinului. Cheia identifică magazinul, deci nu trimiți niciodată un id de magazin.
- [Răspunsuri și erori](https://marketing.conekto.app/dezvoltatori#erori): Un lot nu se oprește la primul obiect greșit: obiectele bune se salvează, iar cele greșite apar în errors, cu poziția lor în listă.
- [Contacte](https://marketing.conekto.app/dezvoltatori#contacte): POST /contacts creează sau actualizează clienți după external_id (id-ul din platforma ta). Fiecare contact are nevoie de email sau telefon.
- [Categorii](https://marketing.conekto.app/dezvoltatori#categorii): POST /categories. Trimite-le înaintea produselor; ierarhia se face cu parent_external_id.
- [Produse](https://marketing.conekto.app/dezvoltatori#produse): POST /products. Produsele apar în recomandări, în blocurile de produse din emailuri și în fluxurile de stoc și preț.
- [Comenzi](https://marketing.conekto.app/dezvoltatori#comenzi): POST /orders. Comenzile calculează venitul atribuit campaniilor și fluxurilor, RFM-ul și segmentele după cumpărături.
- [Evenimente de pe server](https://marketing.conekto.app/dezvoltatori#evenimente): POST /events, pentru ce se întâmplă pe server (de exemplu hook-uri PHP). Pentru navigarea de pe site folosește scriptul; e mai simplu și leagă singur vizitatorul de client.
- [Ștergeri](https://marketing.conekto.app/dezvoltatori#stergere): POST /contacts/delete, /products/delete și /orders/delete primesc o listă de cel mult 500 de external_id. Fiecare ștergere rămâne în jurnalul contului.
- [Scriptul de pe site](https://marketing.conekto.app/dezvoltatori#script): Un singur script pentru evenimente, formulare, pop-up-uri și notificări push. Shopify și WooCommerce îl pun singure; pe alt site îl copiezi din Setări → General.
- [Evenimente vechi din dataLayer](https://marketing.conekto.app/dezvoltatori#datalayer): Dacă site-ul trimite deja evenimente __sm__* în dataLayer (de la platforma de marketing folosită înainte), scriptul nostru le preia singur. Nu trebuie schimbat nimic pe site.
- [Feed de produse și de comenzi](https://marketing.conekto.app/dezvoltatori#feeduri): Pentru mutare sau pentru platformele fără API: un feed XML de produse, citit zilnic, și un feed JSON de comenzi, citit pe pagini. Le configurezi în Setări → Mutare.
- [Webhooks](https://marketing.conekto.app/dezvoltatori#webhooks): Primești pe serverul tău, în timp real, ce se întâmplă în cont. Le adaugi în Setări → Webhooks, unde vezi și ultimele livrări și poți trimite un test.
- [Mediu de test](https://marketing.conekto.app/dezvoltatori#test): Faci integrarea fără ca datele de probă să ajungă în contacte, comenzi sau rapoarte.
- [Documentația pentru asistenți AI](https://marketing.conekto.app/dezvoltatori#ai): Toată documentația, ca un singur fișier text, pentru Claude, ChatGPT sau Cursor.

## Opțional

- [Prețuri](https://marketing.conekto.app/#preturi)
- [Termeni](https://marketing.conekto.app/terms)
- [Acordul de prelucrare a datelor](https://marketing.conekto.app/dpa)