Suara

PandaDoc integráció

Gyors és érthető leírás, hogy hogyan kösd be a PandaDoc fiókodat a Suara rendszerébe.

Haladási szint

0% · Befejezés: 4 perc

Mi a PandaDoc?

A PandaDoc egy dokumentumkezelő és e-aláírási platform. Sablonokból készít ajánlatot vagy szerződést, elküldi aláírásra, és követi, hogy a dokumentumot megnyitották, aláírták vagy elutasították.

Mire használhatod a Suarában?

Ha összekötöd a PandaDocot, az appod adataiból e-aláírásra kész ajánlat vagy szerződés lehet. Néhány példa:

  • Ajánlat: az ajánlatkérő űrlap adataiból a PandaDoc-sablonod alapján ajánlat készül.

  • Szerződés: az ügyfél adatai a szerződéssablon mezőibe kerülnek, majd megy aláírásra.

  • Állapotkövetés: az app lekérdezéssel megmutatja, hogy a dokumentumot megnyitották, aláírták vagy elutasították. A PandaDoc-webhookot a Suara még nem támogatja, ezért az app nem azonnali értesítést kap, hanem például az oldal megnyitásakor kérdezi le az állapotot.

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

  • Dokumentum létrehozása sablonból: kitölti az ügyfél adatait.

  • Küldés aláírásra: elküldi a dokumentumot az ügyfélnek.

  • Állapot lekérdezése: megmutatja, hol tart a dokumentum.

  • Aláírt PDF letöltése: a kész dokumentum PDF-jét az app le tudja tölteni.

Biztonság

Az API-kulcs 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 PandaDocot, 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. Generálj éles API-kulcsot a PandaDocban

  1. Jelentkezz be a PandaDocba.

  2. Nyisd meg az API-beállításokat: https://app.pandadoc.com/a/#/settings/integrations/api (a PandaDoc újabb felületén a Dev Center → Configuration alatt, régebbi felületen Settings → Integrations → API).

  3. Generálj Production kulcsot, majd másold ki.

Fontos: a Sandbox kulcs csak tesztelésre jó, az appban az éles (production) kulcsot add meg. A kulcs a nevedben hozhat létre és küldhet dokumentumokat, ezért ne oszd meg.

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 PandaDocot. 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 „PandaDoc csatlakoztatása” ablak.

  4. Töltsd ki a mezőt:

    • API kulcs: a másolt éles (production) kulcs.

    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 kulcs érvényes, a kapcsolat PandaDoc · {munkaterület neve} 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 egy dokumentumot az Ajánlat sablonból a PandaDocban, és küldd el aláírásra az ügyfélnek.” 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 PandaDoc 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 projektekbe kötéshez be kell kapcsolni a Suara Cloudot. Ha még nincs bekapcsolva, kérd meg az AI-t a chatben. A kapcsolatot ettől függetlenül használhatod csak a chatben is (Csak chat), az appba bekötni később is lehet. A chatben futó műveletekhez ennél az integrációnál külön Chat-hozzáférést (MCP) is össze kell kötni: az Integrációk → Kapcsolataid alatt a kapcsolat részleteinél a Chat-hozzáférés összekötése (MCP) gombbal.

A bekötés után az AI a PandaDoc-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 PandaDoc kapcsolatra kattintva elérhető:

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

  • Kulcsok frissítése: új API-kulcs mentése, ha lecserélted vagy törö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 PandaDocot.

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 kulcs helyesen lett kimásolva (szóköz nélkül), és hogy éles (production) kulcsot használsz, nem sandboxot.

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

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

  • Az aláíró nem kap mezőket: A szerepkör (role) neve pontosan egyezzen a sablonban megadott szerepkörrel.

  • A küldés közvetlenül a létrehozás után hibát ad (409): A dokumentum ilyenkor még feltöltés alatt van. Várd meg, amíg piszkozat (draft) állapotú lesz, és csak utána küldd el.

  • Nem találja a sablont: A sablonnak abban a PandaDoc-munkaterületben kell lennie, amelyhez a kulcs tartozik.

PandaDoc integráció | Suara