PipeDrive integráció

Mi a Pipedrive?

A Pipedrive egy értékesítési CRM. A személyeket, cégeket és dealeket egy értékesítési folyamatban (pipeline) követi, a leadeket pedig külön gyűjti.

Mire használhatod a Suarában?

Ha összekötöd a Pipedrive-ot, az appodból érkező érdeklődők egyenesen az értékesítési folyamatodba kerülnek. Néhány példa:

• Ajánlatkérő űrlap: az űrlap személyt, céget és dealt hoz létre vagy frissít.

• Duplikátum-szűrés: az e-mail-cím alapján nem jön létre kétszer ugyanaz a személy.

• Jegyzet: az érdeklődő üzenete jegyzetként a dealhez kerül.

• Kimutatás vagy ügyfélportál: az app a dealeket ki tudja olvasni.

Az AI az alábbi műveleteket használja:

• Személy és cég létrehozása vagy frissítése: e-mail alapú duplikátum-szűréssel.

• Deal vagy lead létrehozása: új üzleti lehetőséget nyit (a deal szakasza és állapota később módosítható).

• Pipeline-ok és szakaszok lekérése: megmutatja a folyamataidat.

• Jegyzet csatolása: az üzenetet jegyzetként rögzíti.

• Dealek olvasása: lekéri őket.

Biztonság

A személyes API token titkosítva, a Suara szerverén marad. A generált app sosem látja, és a böngészőbe sem kerül. Az app a Suara gatewayen keresztül hívja a Pipedrive-ot, a gateway pedig a háttérben hozzáadja a hitelesítő adatokat. A kapcsolatot a láthatóság beállításával korlátozhatod: Csak én, Csak kiválasztott tagok vagy Az egész munkaterület.

Beállítás lépésről lépésre

1. Szerezd meg az API tokent és a cég-aldomaint a Pipedrive-ban

1. Jelentkezz be a Pipedrive-ba.

2. Nyisd meg az API-beállításokat: https://app.pipedrive.com/settings/api (a profilképed → Personal preferences → API).

3. Másold ki a Your personal API token értékét.

4. A cég-aldomain a Pipedrive-címed eleje: ha a címed acme.pipedrive.com, akkor az aldomain acme.

2. Kösd be a Suarában

1. A Suara oldalsávjában nyisd meg az Integrációk oldalt.

2. A Katalógusban keresd meg a Pipedrive-ot. A CRM kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

3. Kattints a Csatlakoztatás gombra. Megnyílik a „Pipedrive csatlakoztatása” ablak.

4. Töltsd ki a mezőket:

   • API token: a másolt személyes API token.

   • Cég-aldomain: a Pipedrive-címed .pipedrive.com előtti része, például acme.

   A beillesztett titkos érték a Kulcs megjelenítése ikonnal ellenőrizhető. A Hol találom? hivatkozás a szolgáltatás megfelelő oldalára visz.

5. Válaszd ki, ki használhatja a kapcsolatot (Csak én vagy Az egész munkaterület). Ha a teljes munkaterületnek engedélyezed, a Suara figyelmeztet, hogy minden tag használhatja a kapcsolatot a saját projektjeiben.

6. Kattints a Mentés és ellenőrzés gombra. A Suara lekérdezi a fiókodat, és ha a token érvényes, a kapcsolat Pipedrive · {cégnév} néven megjelenik a Kapcsolataid között.

3. Használd a projektedben

Három módon használhatod a kapcsolatot:

• A chatben kérve: írd le az AI-nak, mit szeretnél, például „Az ajánlatkérő űrlap beküldésekor hozz létre vagy frissíts egy személyt a Pipedrive-ban, nyiss hozzá dealt, és csatold az üzenetet jegyzetként.” Ha még nincs kapcsolat, az AI felkínálja a csatlakoztatást.

• Az Integrációk oldalról: a Kapcsolataid között a Pipedrive mellett a Bekötés az appba gombbal kötheted be a kapcsolatot egy projektbe.

• A projekt Kapcsolatok oldaláról: nyisd meg a projekt Kapcsolatok részét, és kattints a Kapcsolat gombra. Ott a Munkaterület kapcsolatai közül választhatsz egy meglévőt, vagy az Új bekötése gombbal újat hozhatsz létre.

A bekötés után az AI a Pipedrive-hívásokat az app szerveroldali (edge function) részében generálja. A hitelesítő adatok így nem kerülnek a kódba, és a kapcsolatot szükség esetén a projekt Kapcsolatok oldaláról bármikor leválaszthatod.

Kapcsolat kezelése

Az Integrációk → Kapcsolataid alatt a Pipedrive kapcsolatra kattintva elérhető:

• Alapadatok: az elnevezés és a láthatóság módosítása.

• Kulcsok frissítése: új token vagy aldomain mentése, ha lecserélted a régit.

• Kapcsolt projektek: itt látod, mely projektek használják a kapcsolatot.

• Utolsó hívások: itt látod a legutóbbi hívásokat (metódus, útvonal, státusz, időtartam, forrás: alkalmazás vagy chat).

• Leválasztás (Veszélyzóna): megszünteti a kapcsolatot. A hozzá kötött projektek ezután nem érik el a Pipedrive-ot.

A státusz lehet Aktív, Hiba vagy Visszavonva. Ha Újracsatlakozás szükséges üzenetet látsz, mentsd újra a kulcsot.

Hibaelhárítás

• „Mentés és ellenőrzés” hibával áll meg: Ellenőrizd, hogy a token helyesen lett kimásolva (szóköz nélkül), és hogy a Cég-aldomain pontosan egyezik a Pipedrive-címed elejével.

• A kapcsolat „Hiba” vagy „Visszavonva” státuszú: A kulcs törölve lett, lejárt, vagy visszavonták. Generálj új tokent a Pipedrive-ban, és mentsd el a Kulcsok frissítése résznél.

• Az app nem éri el a Pipedrive-ot: Ellenőrizd, hogy a kapcsolat be van-e kötve a projektbe, és hogy a Suara Cloud be van-e kapcsolva.

• Rossz aldomain: Ha az aldomain nem egyezik a Pipedrive-címeddel, a hívás nem találja a fiókodat. Add meg csak a .pipedrive.com előtti részt.