# Pâlnii de vânzări

Platforma se conectează la pâlniile tale de vânzări existente, astfel încât, atunci când cineva completează un formular de înscriere pe pagina ta de destinație, acesta este adăugat automat ca și contact și primește un mesaj personalizat - totul fără a fi nevoie să faci ceva manual.

**Pe scurt:** Cineva se înscrie pe site-ul tău și, în câteva minute, primește un mesaj WhatsApp de la botul tău AI care inițiază o conversație reală.


---

## Ce face o integrare de tip pâlnie

Atunci când conectezi pagina ta de destinație la platformă, fiecare lead nou este automat:

1. **Adăugat ca și contact** în aplicație
2. **Adăugat la o listă de contacte specifică** pe care o monitorizează Broadcast-ul tău
3. **Implicat de botul tău AI** cu un mesaj de deschidere personalizat
4. **Urmărit automat** dacă nu răspund

Acest lucru transformă o pagină de înscriere pasivă într-o conversație de vânzări activă - gestionată în întregime de botul tău AI.

**Exemplu: Cum arată în practică**

```
Someone fills out your landing page form
       |
       v
Your automation tool (Pabbly, Zapier, or Make) sends
the lead's info to the platform
       |
       v
The platform creates the contact and adds them to your list
       |
       v
Your Broadcast sends a personalized WhatsApp message
       |
       v
The lead replies, and your AI bot continues the conversation
```

---

## Ce trebuie să colecteze pagina ta de înscriere

Pagina ta de destinație (construită cu ClickFunnels, Leadpages, Systeme.io, WordPress sau orice alt instrument) trebuie să colecteze cel puțin aceste două câmpuri:

### Câmpuri obligatorii

| Câmp | De ce este necesar |
|-------|-----------------|
| **Număr de telefon** | Platforma trimite mesaje prin WhatsApp sau SMS, deci un număr de telefon este esențial. Trebuie să includă prefixul țării (de ex., +40 pentru România). |
| **Prenume** | Folosit pentru a personaliza mesajul de deschidere. Mesajele care conțin numele persoanei au rate de răspuns semnificativ mai mari. |

### Opțional, dar recomandat

| Câmp | De ce ajută |
|-------|-------------|
| **E-mail** | Permite urmărirea pe mai multe canale și ajută la evitarea duplicării contactelor |
| **Nume de familie** | O personalizare mai profesională |
| **Câmpuri personalizate** | Orice date relevante pentru oferta ta (numele companiei, domeniul de interes etc.) |

**Sfat:** Păstrează formularul scurt. Numărul de telefon și prenumele sunt minimul necesar. Fiecare câmp suplimentar pe care îl adaugi scade rata de completare a formularului. Poți oricând să colectezi informații suplimentare prin intermediul conversației propriu-zise.

---

## Configurarea agentului pentru funnel-uri

Un funnel are nevoie de două lucruri: un **Agent AI** care îți cunoaște oferta și răspunde fiecărui lead în același mod, și un **Broadcast** care trimite primul mesaj către lead-urile colectate de funnel-ul tău. Construiește mai întâi Agentul — Broadcast-ul va fi direcționat către acesta.

### Configurare pas cu pas

1. **Începe de la agentul tău**
   - Ai deja unul pentru această ofertă? Sub **AI Studio**, dă click pe **AI Agents** și dă click pe numele acestuia. (Pe telefon, apasă mai întâi pe pictograma de meniu **☰**.)
   - Începi de la zero? Dă click pe **New agent** și fie direcționează-l către site-ul tău — acesta va citi paginile și va scrie instrucțiunile pentru tine — fie alege **Start blank**. Vezi [Crearea unui agent](../ai-agents/ai-agents.md#creating-an-agent).
   - Dă-i un nume descriptiv, de exemplu "Webinar Funnel - Martie 2026".


2. **Configurați botul**
   - La pasul **Instrucțiuni AI**, scrieți instrucțiuni adaptate ofertei din funnel-ul dumneavoastră
   - Adăugați informații despre companie, întrebări frecvente și resurse specifice ofertei la pasul **Întrebări frecvente și cunoștințe**
   - Stabiliți obiectivul conversației (de ex., "Rezervă o ședință de consultanță gratuită")
   - Consultați ghidul [Configurarea botului AI](../ai-automation/ai-bot-setup.md) pentru instrucțiuni detaliate


3. **Activează agentul**
   - Înapoi pe pagina AI Agents, folosește butonul **Activate agent** din rândul respectiv, astfel încât starea acestuia să fie **Active**. De atunci înainte, acesta va răspunde oricui te contactează pe canalele de care este responsabil.
   - Care sunt acele canale este decis de [Entry Points](../ai-agents/entry-points.md) — fie pasul **Entry Points** al agentului, fie panoul **Who answers new conversations** din partea de sus a paginii AI Agents.

4. **Creează Broadcast-ul care trimite primul mesaj**
   - Deschide [Broadcasts](../broadcasts/broadcasts.md) și creează unul. Pasul **Message** conține mesajul de deschidere pe care îl primesc lead-urile tale — include prenumele contactului, fii concis, aceasta este prima ta impresie.
   - La pasul **Replies**, alege agentul pe care tocmai l-ai creat. Aceasta este legătura dintre trimitere și creierul AI.
   - Pe WhatsApp, mesajul de deschidere trebuie trimis către WhatsApp pentru aprobare înainte de a putea fi trimis; vezi [WhatsApp Templates](../templates/whatsapp-templates.md).


5. **Notează ID-ul listei tale**
   - Automatizarea funnel-ului tău are nevoie de ID-ul listei în care ar trebui să adauge lead-urile. Sub **CRM**, deschide **Contacts** → **Lists**, deschide lista către care trimite Broadcast-ul tău și copiază ID-ul acesteia de acolo.


6. **Activează follow-up-urile** (recomandat)
   - Activează follow-up-urile automate la pasul **Follow-ups** al agentului, astfel încât lead-urile care nu răspund să fie reangajate
   - Vezi ghidul [Follow-Up System](../ai-automation/follow-ups.md) pentru detalii


---

## Conectarea funnel-ului tău la aplicație

Platforma funcționează cu toate platformele majore de automatizare. Iată cum să conectezi formularul paginii tale de destinație (landing page).

### Opțiunea 1: Utilizarea Pabbly Connect

Pabbly este eficient din punct de vedere al costurilor și gestionează bine funnel-urile cu volum mare.

**Pași:**

1. **Setează un declanșator webhook** - Acesta se activează când cineva trimite formularul tău de înscriere
2. **Adaugă o întârziere de 15-20 de minute** (opțional, dar recomandat) - Oferă lead-ului timp să îți trimită primul mesaj, creând o conversație mai naturală
3. **Verifică dacă contactul există deja** - Apelează API-ul pentru a evita crearea de duplicate
4. **Creează contactul și adaugă-l în listă printr-un singur apel** - Trimite informațiile acestuia către platformă incluzând ID-ul listei din Broadcast-ul tău (`listId`). O singură cerere creează contactul și îl adaugă în listă, iar adăugarea în listă este cea care declanșează mesajul de deschidere. (Vezi [Direct API Integration](#direct-api-integration) mai jos.)

### Opțiunea 2: Utilizarea Zapier

**Pași:**

1. **Declanșator:** Trimitere nouă de formular de pe landing page-ul tău
2. **Acțiunea 1:** aplicația - Find Contact (verifică dacă există deja)
3. **Filtru:** Continuă doar dacă contactul NU a fost găsit
4. **Acțiunea 2:** aplicația - Create Contact, incluzând ID-ul listei din Broadcast-ul tău, astfel încât contactul să fie creat direct în listă. Dacă preferi API-ul brut, un singur POST "Webhooks by Zapier" către `/v1/contacts` cu `listId` face același lucru - nu este nevoie de un pas separat "Add to List".

### Opțiunea 3: Utilizarea Make (fostul Integromat)

**Pași:**

1. **Declanșator webhook** din funnel-ul tău
2. **Verifică** dacă persoana de contact există deja prin API
3. **Creează** persoana de contact dacă este nouă, transmițând ID-ul listei Broadcast-ului tău (`listId`) în aceeași solicitare - acest lucru creează contactul și îl adaugă în listă dintr-o singură apelare. Un singur modul HTTP POST către `/v1/contacts` gestionează ambele acțiuni.

---

## Integrare API directă

Dacă ai un dezvoltator sau gestionezi propriul backend al site-ului web, te poți conecta direct la API-ul platformei fără un instrument middleware.

### Creați persoana de contact și adăugați-o în listă - dintr-un singur apel

Nu ai nevoie de două solicitări separate. Endpoint-ul pentru crearea contactelor acceptă un `listId`, deci o singură apelare creează contactul **și** îl introduce în lista Broadcast-ului tău - iar adăugarea contactului în acea listă este exact ceea ce declanșează mesajul de deschidere.

```
POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "lastName": "Smith",
  "email": "john@example.com",
  "listId": "YOUR_LIST_ID"
}
```

Pentru a adăuga persoana de contact în mai multe liste simultan, utilizați `listIds` (un tablou) în schimb - acesta are prioritate față de `listId`:

```
{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "listIds": ["list123", "list456"]
}
```

> **Utilizați nume de câmpuri de tip camelCase** (`phoneNumber`, `firstName`, `lastName`) - nu `phone_number` / `first_name`. Orice câmp pe care platforma nu îl recunoaște este stocat în schimb ca un [câmp personalizat](../get-started/custom-contact-fields.md) pe contact, deci un `phone_number` scris greșit ar lăsa contactul fără număr de telefon, iar cererea ar fi respinsă.

### Adăugarea unei persoane de contact existente într-o listă (opțional)

Dacă persoana de contact există deja și trebuie doar să o adăugați într-o listă, utilizați endpoint-ul de adăugare în listă cu ID-ul contactului:

```
POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "contactId": "abc123",
  "listId": "YOUR_LIST_ID"
}
```

Consultați [referința completă a API-ului pentru Contacte](../api/contacts.md) pentru toate câmpurile disponibile.

**Unde găsiți cheia API:** Mergeți la **Setări** (pictograma roată, aproape de partea de jos a barei laterale stângi) → **Integrări** → **Cheie API**.

**Important:** Include întotdeauna codul țării în numărul de telefon (de exemplu, `+1` pentru SUA, `+44` pentru Marea Britanie, `+31` pentru Țările de Jos).

---

## Cum declanșează noii membri ai listei mesajul de deschidere

Acesta este elementul care conectează totul, odată ce Broadcast-ul tău este activ cu opțiunea **Trimite către noii membri ai listei** activată:

1. Un nou contact este adăugat în lista monitorizată de Broadcast-ul tău (prin automatizare, import manual sau manual)
2. Broadcast-ul preia noul contact
3. Mesajul de deschidere este trimis:
   - **1-3 contacte** sunt trimise imediat (acesta este scenariul normal de funnel - o persoană se înscrie pe rând)
   - **4+ contacte simultan** sunt puse automat la coadă și trimise într-un ritm sigur pentru a proteja reputația expeditorului
4. Când contactul răspunde, agentul de la pasul **Răspunsuri** al Broadcast-ului preia conversația

---

## Fluxul complet al pâlniei (de la capăt la capăt)

Iată tot ce se întâmplă atunci când un lead intră în pâlnia ta:

1. **Lead-ul completează formularul de înscriere** pe pagina ta de destinație
2. **Instrumentul tău de automatizare** (Pabbly, Zapier, Make) primește datele din formular
3. **Întârziere opțională de 15-20 de minute** pentru a vedea dacă lead-ul îți trimite mesaj primul
4. **Automatizarea verifică** dacă persoana de contact există deja în aplicație
5. **Contactul este creat în lista ta** printr-o singură apelare API (ID-ul listei Broadcast-ului este inclus în solicitarea de creare, astfel încât crearea și adăugarea în listă se întâmplă simultan)
6. **Broadcast-ul trimite** mesajul șablon WhatsApp de deschidere
7. **Lead-ul citește mesajul** și răspunde
8. **Bot-ul tău AI** se implică într-o conversație personalizată
9. **Bot-ul lucrează pentru atingerea obiectivului tău** (programare, calificare lead, partajare ofertă)
10. **Dacă lead-ul nu mai răspunde**, mesajele automate de follow-up îi reangajează
11. **Dacă bot-ul are nevoie de ajutor**, alertează un membru al echipei pentru a prelua conversația

---

## Cele mai bune practici

1. **Adaugă o scurtă întârziere înainte de a crea contactul.** O întârziere de 15-20 de minute oferă lead-urilor timp să îți trimită mesaje primii. Dacă o fac, aceștia intră în fluxul de intrare (o conversație mai naturală). Dacă nu, se trimite șablonul de ieșire.

2. **Activează Trimite către noii membri ai listei pentru funnel-urile în curs.** La pasul **Audiență** al Broadcast-ului, acea setare menține Broadcast-ul monitorizând lista după lansare, astfel încât fiecare lead nou care se înscrie primește automat mesajul de deschidere. Lead-urile care îți trimit mesaj primele sunt gestionate de același agent prin Punctele sale de Intrare, astfel încât ambele direcții ajung în aceeași configurație.

3. **Personalizează mesajul de deschidere.** Include întotdeauna prenumele contactului în șablonul WhatsApp. Mesajele de deschidere generice au rate de răspuns mult mai mici.

4. **Păstrează mesajul de deschidere scurt.** Două-trei propoziții sunt ideale. Pune o întrebare pentru a invita la un răspuns. De exemplu: „Bună, {first_name}! Mulțumim pentru înscrierea la consultația noastră gratuită. Care este cea mai mare provocare cu care te confrunți în legătură cu [subiect] în acest moment?”

5. **Activează follow-up-urile.** Lead-urile din pâlnie sunt calde, dar ocupate. Un follow-up după 24-72 de ore îi readuce adesea înapoi.

6. **Testează întregul flux înainte de lansare.** Trimite o înscriere de test pe pagina ta de destinație, verifică dacă contactul este creat în aplicație și confirmă că mesajul de deschidere a sosit.

7. **Monitorizează ratele de conversie.** Urmărește câți lead-uri din funnel răspund la mesajul de deschidere și câți convertesc conform obiectivului tău (programare, vânzare etc.) din statisticile Broadcast-ului. Ajustează instrucțiunile AI și mesajul de deschidere pe baza a ceea ce înveți.

8. **Previno duplicatele.** Verifică întotdeauna dacă un contact există înainte de a-l crea. Contactele duplicate duc la conversații confuze și la irosirea creditelor.

9. **Obține consimțământul adecvat.** Asigură-te că pagina ta de înscriere precizează clar că lead-ul va primi mesaje WhatsApp. Include o căsuță de bifare pentru consimțământ, dacă este necesar în regiunea ta.

---

## Pașii următori

- [Trecerea de la Campanii la Broadcast-uri și Agenți](../moving-from-campaigns.md) - unde se află acum fiecare setare veche de campanie.
- [Sistem de Follow-Up](../ai-automation/follow-ups.md) - reangajează lead-urile din funnel care nu mai răspund.
- [Broadcast-uri](../broadcasts/broadcasts.md) - ghidul complet pentru configurarea părții de trimitere.
- [Referință API Contacte](../api/contacts.md) - fiecare câmp pe care îl acceptă endpoint-ul de creare a contactelor.