Documentație tehnică

Pentru cei care integrează Convia direct cu codul propriu. Începem cu widget-ul de site (cea mai folosită integrare), restul vine pe parcurs.

Pornire rapidă: widget pe site

Timp estimat: 2 minute

Pui scriptul de mai jos înainte de tag-ul de închidere </body> pe orice pagină unde vrei să apară botul. Cheia cv_… o găsești în dashboard, în tab-ul „Instalare” al botului tău (de acolo copiezi snippetul deja completat).

<script
  src="https://widget.convia.ro/embed.js"
  data-convia-key="cv_cheia_ta"
  async
></script>

Funcționează pe WordPress, Shopify, Webflow, Gomag, Magento sau orice site HTML. Pe WordPress poți folosi un plugin de tip „Insert Header and Footer” pentru același rezultat.

Atribute disponibile
  • data-convia-keyCheia publică a botului (începe cu cv_). Obligatoriu.
  • data-api-urlOpțional. Adresa API-ului, doar pentru medii de test; în producție se folosește automat https://api.convia.ro/api.

Culoarea, poziția, mesajul de bun venit și sugestiile rapide se setează din dashboard (tab-ul „Aspect”), nu din atribute: se aplică instant, fără să schimbi codul de pe site. Widget-ul restricționează, opțional, domeniile pe care rulează („Domenii permise”, tot din dashboard).

Restul documentației vine pe parcurs.

Publicăm fiecare secțiune când o terminăm. Dacă ai nevoie urgent de ceva specific, scrie-ne și-ți răspundem în detaliu pe email.

Configurare widget

În scriere

Personalizare avansată: mesaj de bun venit, sugestii rapide, comportament la mobile, declanșatoare.

WhatsApp Business API

În lucru

Conectarea contului oficial de WhatsApp Business, verificarea Meta și gestionarea șabloanelor de mesaje aprobate.

API REST

Planificat

Autentificare, conversații, contacte, agenți, knowledge base. Pentru integrări custom în sistemele tale.

Webhooks

Planificat

Primește evenimente în timp real direct în sistemele tale (conversație nouă, preluare umană sau mesaj marcat important).