Files
twenty/packages/twenty-docs/l/ro/user-guide/workflows/external-tool-integration.mdx
T
github-actions[bot] 9bc5486d0d i18n - translations (#15803)
Created by Github action

---------

Co-authored-by: github-actions <github-actions@twenty.com>
2025-11-13 17:12:39 +01:00

221 lines
10 KiB
Plaintext

---
title: Integrare Unelte Externe
info: Aceste fluxuri de lucru se concentrează pe aducerea și scoaterea datelor în și din Twenty prin apeluri API și webhooks.
image: /images/user-guide/integrations/plug.png
sectionInfo: Automatizați procesele și integrați cu instrumente externe
---
<Frame>
<img src="/images/user-guide/integrations/plug.png" alt="Header" />
</Frame>
Mai jos sunt exemple de fluxuri de lucru pe care le-ați putea implementa pentru a conecta Twenty cu restul stack-ului dvs.
## Cazuri de Utilizare pentru Ingestia Datelor
### Trimiteri Formular Web
**Problemă**: Trebuie să captați potențiali clienți din formularele de pe site, paginile de destinație sau formulare de contact direct în Twenty.
**Soluție**: Utilizați declanșatoare webhook pentru a crea automat înregistrări din trimiterile de formulare.
**Configurare**:
- Creează un flux de lucru cu un declanșator Webhook
- Configurați webhook-ul pentru a aștepta datele formularului (nume, email, companie etc.)
- Setați metoda webhook-ului la POST
- Definește structura corpului așteptată în declanșator
**Declanșator**: Webhook (cerere POST de la formularul dvs.)
**Acțiuni**:
- Căutați Înregistrări pentru a verifica dacă persoana/compania există deja
- Branch: If exists → Update Record, If not → Create Record
- Crează Înregistrare pentru sarcină de urmărire atribuită reprezentantului de vânzări
- Trimite notificare prin Email echipei de vânzări
### Sincronizarea Datelor Produsului
**Problemă**: Echipa dvs. de vânzări are nevoie de vizibilitate asupra utilizării produsului, facturării sau datelor de adopție a caracteristicilor stocate în depozitul dvs. de date.
**Soluție**: Sincronizați regulat datele produsului în Twenty pentru a oferi vânzătorilor context despre conturile lor.
**Declanșator**: Pe un Program (zilnic sau săptămânal)
**Acțiuni**:
- Cerere HTTP către API-ul depozitului dvs. de date
- Acțiune de cod pentru a procesa și formata datele
- Utilizați funcția Iterator pentru pașii următori
- Căutați Înregistrări pentru a găsi înregistrări de companii corespunzătoare
- Actualizează Înregistrarea pentru a adăuga metrici de utilizare a produsului
- Creare Înregistrare pentru sarcini când utilizarea scade sub prag
### Note de Întâlnire din Înregistrările Apelurilor
**Problemă**: Perspective importante din apelurile de vânzări se pierd sau nu sunt documentate corect în CRM.
**Soluție**: Creați automat note și elemente de acțiune din sistemele de înregistrare a apelurilor.
**Declanșator**: Webhook (de la platforma de înregistrare a apelurilor)
**Acțiuni**:
- Acțiune de cod pentru a extrage rezumatul întâlnirii și elementele de acțiune
- Căutați Înregistrări pentru a găsi oportunitatea sau contactul relevant
- Creare Înregistrare pentru o notă cu rezumatul întâlnirii
- Creare Înregistrare pentru sarcini de urmărire bazate pe elementele de acțiune
- Trimite Email participanților cu rezumatul și pașii următori
### Îmbogățirea Datelor
**Problemă**: Înregistrările dvs. de contacte și companii lipsesc informații demografice și firmografice importante.
**Soluție**: Îmbogățiți automat înregistrările folosind furnizori de date externi.
**Declanșator**: Înregistrarea este Creată (obiecte de Tip Persoane sau Companii)
**Acțiuni**:
- Cerere HTTP către API-ul de îmbogățire
- Acțiune de cod pentru a procesa răspunsul de îmbogățire
- Utilizați funcția Iterator pentru pașii următori
- Actualizează Înregistrarea cu informații suplimentare despre companie/contact
- Creare Înregistrare pentru sarcină de vânzări dacă este identificat un potențial client de valoare mare
- Trimite Email de alertă dacă îmbogățirea dezvăluie semnale cheie de cumpărare
## Cazuri de Utilizare pentru Distribuția Datelor
### Managementul Abonamentelor la Newsletter
**Problemă**: Doriți să trimiteți e-mailuri de marketing segmentelor specifice ale datelor dumneavoastră CRM folosind instrumente specializate de e-mail.
**Soluție**: Exportați liste de abonați către platforma dumneavoastră de marketing prin email atunci când este necesar.
**Configurație**: Creați o vizualizare în Twenty cu toți destinatarii newsletterului.
**Declanșator**: Lansare Manuală (când nu este selectată nicio înregistrare)
**Acțiuni**:
- Căutați Înregistrări folosind criteriile de vizualizare ale newsletterului.
- Acțiune de cod pentru a formata adresele de email pentru platforma dumneavoastră de email.
- Cerere HTTP pentru a adăuga abonați la instrumentul dumneavoastră de marketing prin email.
- Creați Înregistrare pentru monitorizarea campaniei.
- Trimiteți confirmarea pe email echipei de marketing.
### Declanșatoare ale secvenței de emailuri.
**Problemă**: Doriți să declanșați secvențe de e-mail sofisticate bazate pe evenimentele din CRM folosind instrumente dedicate de automatizare a e-mailurilor.
**Soluție**: Trimiteți potențialii clienți noi sau clienți către platforma dumneavoastră de automatizare a emailurilor atunci când apar evenimente specifice.
**Declanșator**: Înregistrarea este Creată (obiect de tip Persoane cu criterii specifice).
**Acțiuni**:
- Acțiune de cod pentru a determina secvența de email corespunzătoare.
- Cerere HTTP pentru a adăuga contactul la platforma de automatizare a e-mailului.
- Actualizați Înregistrarea pentru a urmări înscrierea în secvență.
- Creați Înregistrare pentru sarcina de urmărire pentru a monitoriza implicarea.
### Integrare Scoring Potențiali Clienți.
**Problemă**: Aveți nevoie de un scoring sofisticat al potențialilor clienți care combină datele CRM cu semnalele externe.
**Soluție**: Trimiteți datele despre potențiali clienți către instrumentele externe de scoring sau implementați logica de scoring în fluxurile de lucru.
**Opțiunea 1 - Instrument Extern**:
**Declanșator**: Înregistrarea este Actualizată (obiect de tip Persoane).
**Acțiuni**:
- Cerere HTTP pentru a trimite datele potențialilor clienți către platforma de scoring.
- Acțiune de cod pentru a procesa răspunsul de scor.
- Actualizați Înregistrarea cu scorul potențialului client.
- Creați Înregistrare pentru sarcina de vânzări dacă scorul depășește pragul.
**Opțiunea 2 - Logică Internă**:
**Declanșator**: Înregistrarea este Actualizată (obiect de Tip Persoane).
**Acțiuni**:
- Acțiune de cod cu algoritm de scoring (dimensiunea companiei, industria, comportament).
- Actualizați Înregistrarea cu scorul calculat.
- Trimiteți alerte prin e-mail către reprezentantul de vânzări pentru potențialii clienți cu scor ridicat.
### Generare Factură.
**Problemă**: Când se finalizează afacerile, sistemul dumneavoastră de facturare trebuie actualizat cu informațiile despre client și afacere.
**Soluție**: Trimiteți automat datele despre afaceri către sistemul dumneavoastră de facturare atunci când oportunitățile sunt câștigate.
**Declanșator**: Înregistrarea este Actualizată (Obiecte de Tip Oportunități, Stadiu = "Finalizat Câștigat").
**Acțiuni**:
- Căutați Înregistrări pentru a obține informații complete despre client.
- Acțiune de cod pentru a formata datele pentru sistemul de facturare.
- Cerere HTTP pentru a crea un client în platforma de facturare.
- Cerere HTTP pentru a genera factura.
- Actualizați Înregistrarea pentru a stoca referința facturii.
- Trimiteți un e-mail către echipa financiară cu detaliile facturii.
## Tipare Avansate de Integrare.
### Sincronizare Bi-direcțională.
**Problemă**: Trebuie să păstrați datele sincronizate între Twenty și un alt sistem în ambele direcții.
**Soluție**: Combinați fluxurile de lucru programate cu declanșatoarele Webhook pentru sincronizare în timp real.
**Din Twenty către Sistemul Extern**:
**Declanșator**: Înregistrarea este Actualizată (orice obiect relevant).
**Acțiuni**:
- Cerere HTTP pentru a actualiza sistemul extern.
- Actualizați Înregistrarea pentru a urmări statusul de sincronizare și marcajul de timp.
**Din Sistemul Extern către Twenty**:
**Declanșator**: Webhook (de la sistemul extern).
**Acțiuni**:
- Căutați Înregistrări pentru a găsi înregistrări corespunzătoare.
- Actualizați Înregistrarea cu date noi de la sistemul extern.
- Creați Înregistrare pentru sarcina de rezolvare a conflictelor dacă este necesar.
### Procesare În Mai Multe Etape a Datelor.
**Problemă**: Datele din surse externe necesită o procesare complexă înainte de a putea fi utilizate în Twenty.
**Soluție**: Utilizați acțiuni de cod pentru transformarea și validarea datelor.
**Declanșator**: Webhook sau Pe Un Program.
**Acțiuni**:
- Acțiune de cod pentru a valida formatul datelor primite.
- Acțiune de cod pentru a transforma structura datelor.
- Acțiune de cod pentru a aplica reguli de afaceri și calcule.
- Căutați Înregistrări pentru a verifica duplicatele.
- Creați sau Actualizați Înregistrarea cu datele procesate.
- Trimiteți alerte prin e-mail dacă se detectează probleme de calitate a datelor.
## Sfaturi pentru Implementare.
- Stocați chei API securizat în Setări → API & Webhooks.
- Folosiți HTTPS pentru toate apelurile API externe.
- Fiți atenți la limitele de rată ale API-ului - utilizați fluxuri de lucru programate când este posibil.
- Luați în considerare actualizările în loturi "Pe Un Program" când procesarea în timp real nu este necesară.
- Amintiți-vă de limita de 100 de fluxuri de lucru simultane pe spațiu de lucru - folosiți disponibilitatea "Bulk" pentru declanșatori manuali când procesați mai multe înregistrări (vedeți [Caracteristicile fluxurilor de lucru](/l/ro/user-guide/workflows/workflow-features) pentru detalii).
- Testați cu date de probă înainte de a activa fluxurile de lucru.
Pentru depanarea problemelor de integrare, consultați ghidul nostru [Depanarea Fluxurilor de Lucru](/l/ro/user-guide/workflows/workflow-troubleshooting). Pentru ajutor la implementarea integrărilor complexe, luați în considerare serviciile noastre [Servicii Profesionale](/l/ro/user-guide/workflows/professional-services).