Integrari si API

Integrari si API

Conecteaza Kumulator cu restul ecosistemului tau de aplicatii prin API si integrari native.

Generarea cheilor API

1. Navigheaza la Setari > API — Apasa pe + Cheie Noua.

2. Denumeste cheia — Foloseste un nume descriptiv care indica scopul (ex: „Integrare Website", „Zapier Sync").

3. Seteaza permisiunile — Alege ce resurse poate accesa cheia:

   • Contacte (citire/scriere)
   • Deal-uri (citire/scriere)
   • Companii (citire/scriere)
   • Activitati (citire/scriere)

4. Genereaza cheia — Copiaz-o imediat, deoarece nu va mai fi afisata complet ulterior.

Configurarea webhooks

Webhooks-urile trimit notificari automate catre aplicatiile tale cand au loc evenimente in Kumulator.

1. Acceseaza Setari > Webhooks — Apasa pe + Webhook Nou.

2. Configureaza:

   • URL — Adresa la care Kumulator trimite datele (endpoint-ul tau).
   • Evenimente — Selecteaza ce evenimente declanseaza webhook-ul:
     • Contact creat/actualizat/sters
     • Deal creat/mutat/castigat/pierdut
     • Activitate logata
   • Secret — O cheie secreta pentru a verifica autenticitatea cererilor.

3. Testeaza — Apasa Trimite Test pentru a verifica ca endpoint-ul tau raspunde corect.

Integrare Zapier

1. Cauta Kumulator in Zapier — Adauga aplicatia Kumulator la contul tau Zapier.
2. Autorizeaza — Introdu cheia API generata.
3. Creeaza Zaps — Exemple populare:
   • Formular Typeform completat → Creaza contact in Kumulator
   • Deal castigat → Trimite notificare Slack
   • Contact nou → Adauga in lista Mailchimp

Endpoint-uri API principale

• GET /api/contacts — Lista contacte (cu paginare si filtre)
• POST /api/contacts — Creeaza contact nou
• GET /api/deals — Lista deal-uri
• POST /api/deals — Creeaza deal nou
• PATCH /api/deals/:id — Actualizeaza deal
• GET /api/activities — Lista activitati

Documentatia completa API este disponibila la docs.kumulator.com/api.

Nota: Cheile API au aceleasi permisiuni ca rolul utilizatorului care le-a generat. Foloseste conturi dedicate pentru integrari.