De ce să conectezi site-ul la VAUNT

Fiecare completare a formularului de contact de pe site-ul tău poate ajunge automat în VAUNT ca lead — cu sursă, campanie, proiect și chiar agent asignat. Fără integrare, lead-urile rămân doar pe email și trebuie adăugate manual.

Ai trei căi de conectare:

1. Direct prin API-ul VAUNT — metoda standard: dezvoltatorul site-ului trimite lead-urile din formulare către API.
2. Prin Zapier — dacă folosești form buildere populare (Elementor PRO, MetForm etc.) sau vrei reguli de rutare fără cod.
3. Formularele de lead-uri Facebook/Meta — integrare nativă separată, fără API; vezi articolul dedicat.

Important: integrarea se implementează pe site, de către dezvoltatorul sau agenția care îl administrează — rolul tău în VAUNT este să le dai credențialele și documentația de mai jos.

Pasul 1: Găsește credențialele API

Mergi la Configurări → tabul CANALE PROMOVARE. Sus găsești secțiunea VAUNT API, cu tabelul Credențiale API: Agency UUID, Agency ID, Authorization (Bearer) și API Token — cheia secretă, mascată (apasă iconița cu ochi pentru a o afișa).

Acestea sunt datele de care are nevoie echipa ta web (sau Zapier). Tratează API Token ca pe o parolă — nu îl publica.

Autentificarea folosește Agency UUID (headerul agency-uuid) împreună cu API Token (headerul Authorization: Bearer). Agency ID nu se folosește la autentificare.

Nu vezi meniul Configurări? Este disponibil managerilor cu permisiunea de acces la Configurări — cere echipei VAUNT să o activeze, apoi reloghează-te ca să apară meniul.

Pasul 2: Trimite documentația echipei care administrează site-ul

Tot în secțiunea VAUNT API, la Documentație API, ai trei resurse: Swagger → link API Docs (documentația tehnică a endpoint-urilor), Ghid → Google Docs (integrare pas cu pas; exemplul folosește Contact Form 7 pe WordPress) și Tutorial → Loom (video demonstrativ).

Folosești alt form builder (Elementor PRO, MetForm etc.)? Nu e o problemă: dezvoltatorul trimite datele direct către API conform Swagger, sau folosești Zapier (vezi mai jos).

Ghid

Google Docs: https://docs.google.com/document/d/1lPHxn6KEqL6eD7Jkvpgrq3UZPPUrJ_VZE3YFCj4ws1E/edit

Tutorial

Loom: https://www.loom.com/share/c801872c7b3449f1a3684c99aea8ae04

Ce arată videoul (1:13): Din pagina de configurări, canale de promovare, copiezi API Token-ul și Agency UUID-ul. Trimiți apoi un request POST cu headerul Authorization: Bearer (valoarea token-ului) și headerul agency-uuid (valoarea Agency UUID), cu un body JSON minim. Videoul arată răspunsul de succes și faptul că request-ul poate fi generat în limbajul preferat (JavaScript, Node.js, PHP).

Pasul 3: Verifică permisiunile API

Sub credențiale găsești lista Permisiuni API — ce poate face integrarea ta:

• Adăugare Lead-uri [contact_leads] — necesară pentru formulare;
• Listare Clienți [clients_retrieval];
• Căutare client după Telefon [search_by_phone] — utilă pentru centrale telefonice;
• Apeluri Telefonice [phone_calls];
• Listare proprietăți [properties_list] și Listare proiecte [projects_list] — pentru afișarea ofertei pe site-ul tău.

Activarea sau dezactivarea unei permisiuni se face de echipa VAUNT — scrie-ne ce ai nevoie și o activăm pe contul tău.

Ce date poate trimite formularul

Pe lângă datele de contact (prenume, nume, email, telefon, mesaj), formularul poate trimite câmpuri care clasifică și rutează lead-ul automat. Lead-urile se trimit prin POST https://api.vaunt.ro/v1/external/contact:

• from — sursa lead-ului (de exemplu website); lista valorilor acceptate e disponibilă prin API (GET https://api.vaunt.ro/v1/external/contact/from_list);
• utm_source, utm_medium, utm_campaign (plus utm_content, utm_term, gclid);
• project_id — proiectul de interes (ID-ul e vizibil în adresa paginii proiectului) și property_id — unitatea de pe a cărei pagină vine mesajul;
• agent_id — agentul căruia i se asignează lead-ul;
• tags — etichete (de exemplu numărul de camere căutat);
• marketing_accepted — acordul GDPR de marketing bifat în formular;
• stage — stadiul inițial; implicit lead-ul intră ca necontactat.

Regulă utilă: un lead are o singură sursă — pentru detalii suplimentare folosește tag-urile și câmpurile UTM, nu surse multiple.

Cum ajung lead-urile la agentul potrivit

• Implicit, lead-urile de pe site intră neasignate — asignarea automată nu se face din VAUNT, ci de sursa care trimite lead-ul.
• Pentru rutare pe sursă sau campanie („campania X → agentul Y"), site-ul sau platforma de marketing trimite agent_id în payload.
• Pentru reguli avansate (apartamente → agent X, terenuri → agent Y) folosește Zapier ca strat de rutare.
• Pentru distribuție automată echilibrată există modulul Round Robin — plătit separat, 30 EUR + TVA / lună / cont, activat și configurat de echipa VAUNT.

Integrarea prin Zapier

Zapier se conectează cu aceleași credențiale API din Configurări → CANALE PROMOVARE. În Zap, folosește acțiunea de creare a unui mesaj de lead („create lead message"); câmpul sursă și tag-urile se pot compune din datele formularului. E soluția recomandată când form builder-ul nu poate trimite direct către API sau când ai nevoie de rutare condiționată.

Cum testezi și cum verifici că funcționează

• Testarea se face direct în contul tău (nu există cont demo/sandbox); lead-urile de test se șterg după aceea.
• Completează chiar tu formularul de pe site și verifică dacă apari ca lead nou în Contacte → Portofoliu lead-uri.
• Fiecare mesaj primit prin API apare în Analitice → Mesaje, tabul MESAJE API — aici verifici dacă formularul chiar a ajuns în VAUNT. 

• Un lead existent (același telefon/email) nu se creează a doua oară: mesajul nou se atașează lead-ului existent, stadiul nu se schimbă, iar lead-ul apare în tabul DUBLATE. De aceea lead-urile pe sursă pot fi mai puține decât formularele completate.

Sens invers: afișezi proprietățile din VAUNT pe site-ul tău

• Prin API poți citi datele: Listare proprietăți [properties_list] și Listare proiecte [projects_list] (cere activarea permisiunilor).
• Alternativ, pe aceeași pagină CANALE PROMOVARE ai blocul Feed CSV pentru website, cu câte un URL pentru fiecare tip de proprietate. Atenție: blocul de deasupra, Export pentru website, este altceva — butoanele de acolo generează un export punctual, pe care îl primești pe email, nu URL-ul feed-ului. Feed-ul conține doar proprietățile modificate în ultimele 24 de ore — este un feed incremental de actualizări, nu catalogul complet — iar conținutul se reîmprospătează la fiecare oră. Separat, ai linkul proprietăților șterse în ultimele 24 de ore. Feed-ul se activează de echipa VAUNT pe contul tău. Pentru catalogul complet folosește endpoint-urile de listare din Swagger (Listare proprietăți [properties_list] / Listare proiecte [projects_list]) sau webhooks.
• Nu există API de scriere pentru proprietăți — nu poți crea sau actualiza proprietăți în VAUNT din sisteme externe; folosește aplicația sau importul Excel.

Întrebări frecvente

Am refăcut site-ul — cum leg formularul de contact ca lead-urile să intre direct în VAUNT?

Trimite echipei care a făcut site-ul credențialele și documentația din Configurări → CANALE PROMOVARE (secțiunea VAUNT API); implementarea se face pe site.

Aveți documentație pentru integrarea Contact Form 7?

Da — ghidul din Documentație API (linkul Google Docs) descrie exact integrarea pe Contact Form 7, plus un video Loom. Mai multe detalii — ghidul de integrare Contact Form 7: https://docs.google.com/document/d/179VAtGV27KjMoehj2y1ba1RTsp4RhO6fpxs32ub7W3I/edit și tutorialul video: https://www.loom.com/share/54061aa2b07248e08e3fedc686888fff.

Noi folosim Elementor PRO / MetForm, nu Contact Form 7. Se poate?

Da: fie dezvoltatorul trimite datele direct către API conform Swagger, fie conectezi formularul prin Zapier.

Cum fac ca lead-urile de pe campania X să intre automat la agentul Y?

VAUNT nu are reguli native de rutare pe campanie: sursa trebuie să includă agent_id în payload, sau folosești Zapier. Pentru distribuție echilibrată există Round Robin (plătit separat).

Ne puteți da un cont demo ca să testăm implementarea API?

Nu există conturi demo — testarea se face în contul tău real, iar lead-urile de test se șterg după verificare.

Lead-urile de pe site ajung pe email, dar nu intră în VAUNT. De ce?

Emailul și trimiterea către VAUNT sunt circuite diferite — de obicei unul dintre formulare nu e legat corect, iar remedierea ține de dezvoltatorul site-ului. Verifică în MESAJE API dacă mesajele ajung; un lead existent nu se creează din nou (apare la DUBLATE).

Pot trimite proprietăți către VAUNT prin API (POST/PUT)?

Nu — API-ul permite doar citirea proprietăților și proiectelor. Pentru adăugare în masă folosește importul Excel.

Ce trec la sursă (from) pentru lead-urile de pe site?

Ce trimite site-ul, aceea este sursa. Folosește o valoare din lista de surse (GET https://api.vaunt.ro/v1/external/contact/from_list); o sursă personalizată o adaugi întâi în Configurări → DETALII COMPANIE → Surse lead-uri / clienți.

Cum activez o permisiune API (de exemplu Listare proprietăți [properties_list])?

Scrie echipei VAUNT ce permisiune ai nevoie — activarea se face de către noi, pe contul tău.

Vreau să conectez un tool propriu / un agent AI la datele din VAUNT. Se poate?

Da — cu aceleași credențiale din VAUNT API și endpoint-urile de listare din Swagger. Dacă nu vezi Configurări, cere-ne să îți activăm accesul.

Alte detalii API

API-ul VAUNT are două părți: preluarea lead-urilor în VAUNT și sincronizarea proprietăților către site-ul tău.

1) Preluarea lead-urilor în VAUNT

Mai jos găsești linkurile utile pentru cele trei căi de conectare de la începutul articolului — API-ul VAUNT, Zapier și formularele Facebook/Meta — plus canalul suplimentar prin care lead-urile mai pot intra automat: email-urile trimise de imobiliare.ro.

• Zapier. Aplicația noastră se poate accesa de aici: https://zapier.com/apps/vaunt/integrations Datele de acces sunt credențialele de la Pasul 1. Câmpurile acceptate pentru formularul de contact sunt definite și explicate direct în Zapier.
• Direct prin API-ul VAUNT. Documentație — Formular contact: https://docs.google.com/document/d/11VNvoOfV5FaXC5qOMf_spfiusFUc2XB0WJIRhRNjdmA/edit și tutorialul video: https://www.loom.com/share/c801872c7b3449f1a3684c99aea8ae04.
• Din email-urile trimise de imobiliare.ro. Contul de email (IMAP) pe care ajung mesajele de la imobiliare.ro trebuie adăugat la secțiunea de conturi de email a unuia dintre agenții din VAUNT.
• Din formularele de lead Facebook, prin API-ul Facebook. Legătura dintre VAUNT și Facebook/Instagram se face din Configurări → CANALE PROMOVARE, link direct: https://cloud.vaunt.ro/admin/website/promo. Ai nevoie de un cont de manager cu acces la această secțiune.

2) Preluarea și sincronizarea proprietăților

Webhooks, sincronizare în timp real

VAUNT oferă suport pentru webhooks, ca să sincronizezi proprietățile în timp real. Detalii în documentul de mai jos:

Preluarea și sincronizarea proprietăților: https://docs.google.com/document/d/1HvCkPCVT_Cx3q-gA-n-5epua1iPozVfEMzrDOwB3cHw/edit

Feed CSV, sincronizare periodică

Dacă nu poți folosi webhooks, folosește feed-ul CSV din blocul Feed CSV pentru website. Detalii mai jos:

Preluarea și sincronizarea proprietăților prin CSV: https://docs.google.com/document/d/1sx14ex5p1nzcuSv6ChSNL5uD-NKHSayLsFyJ4xZKKfg

Tutorial pentru conectarea WordPress Contact Form 7 la VAUNT

Ce arată videoul (2:25): Instalezi plugin-ul VAUNT din documentație (din dashboard-ul WordPress sau copiind fișierele în directorul de plugins) și îl activezi. În formularul de contact apare un tab VAUNT unde completezi Agency UUID-ul și API Token-ul, bifezi trimiterea către VAUNT și mapezi câmpurile — nume, email, telefon, mesaj — schimbând numele lor și în tabul Mail. Când sunt corecte apar cu verde, iar istoricul mesajelor trimise îl vezi tot în tabul VAUNT, în josul paginii.