Agent comenzi AI: cum conectez propriul agent de chat la BOCP

Introducere

Agentul comenzi AI permite unui agent de chat propriu — de exemplu un bot de WhatsApp sau asistentul de chat al magazinului, găzduit de dumneavoastră sau de un partener — să răspundă clienților cu date din BOCP: stadiul comenzilor, retrimiterea facturii, stocul unui produs, catalogul și plasarea de comenzi noi. Agentul se configurează în Conectori AI → Agenți chat.

Pe aceeași pagină există și agentul de tip OnChat, care doar informează clientul despre stadiul unei comenzi după numărul ei (vezi Integrare OnChat pe magazinul online). Agentul comenzi recunoaște clientul după numărul lui de telefon, verifică stocul și poate plasa comenzi. Ambele sunt diferite de Agenții AI (Claude, ChatGPT), care citesc datele firmei pentru analize și rapoarte — vezi Cum conectez un asistent AI la BOCP.

Ce poate face agentul

Stadiul comenzilor după telefonul clientului — agentul primește cele mai recente 5 comenzi ale clientului din ultimele 90 de zile, de la cea mai nouă; comenzile anulate nu apar. Pentru fiecare comandă primește data, stadiul (înregistrată, în procesare, facturată, expediată, livrată sau anulată), dacă s-a emis factura, curierul, numărul AWB, linkul de urmărire a coletului, dacă coletul a fost preluat de curier sau livrat, și produsele comandate cu cantitățile lor, inclusiv dacă fiecare produs se află deja pe documentul de vânzare.
O comandă anume, după număr — răspunsul vine doar dacă comanda aparține telefonului clientului; altfel agentul primește răspunsul „comanda nu a fost găsită”.
Retrimiterea facturii — BOCP trimite factura emisă pe adresa de email a clientului înregistrată în BOCP, niciodată pe o adresă comunicată în conversație. Aceeași factură poate fi retrimisă cel mult o dată la 24 de ore.
Stocul unui produs — după codul produsului sau codul de bare, cu potrivire exactă, doar în gestiunea aleasă pe agent și doar pentru produsele publicate pe conectorul de comenzi al agentului: stocul, cantitatea rezervată, cantitatea disponibilă și momentul ultimei actualizări. Prețurile nu sunt comunicate.
Catalogul — doar produsele publicate pe conectorul de comenzi al agentului, cu stocul din gestiunea aleasă pe agent.
Plasarea de comenzi — comanda intră în Comenzi eCommerce pe conectorul de comenzi al agentului; detaliile sunt în secțiunea următoare.

Comenzile plasate prin agent

Prețurile vin din catalogul agentului. Prețul fiecărui produs se ia din catalogul agentului (inclusiv prețul promoțional, dacă există); prețurile trimise de agentul de chat sunt înlocuite. Dacă un cod de produs nu se află în catalogul agentului, întreaga comandă este refuzată.
Ce se ignoră. Plățile, anularea, stadiul comenzii și liniile de discount trimise de agentul de chat nu sunt preluate.
Telefonul clientului. Pe comandă se scrie telefonul expeditorului verificat, trimis de platforma de chat, nu un număr scris în conversație.
Confirmarea operatorului. Fiecare comandă plasată prin agent așteaptă confirmarea unui operator în Comenzi eCommerce înainte de orice procesare automată (rezervare de stoc, bon, factură, AWB). Conectorul de comenzi al agentului se creează cu confirmare manuală; administratorul poate schimba această setare pe conector, după care comenzile urmează fluxul obișnuit al conectorului.

Abonamente și limite

Cele două tipuri de agenți au abonamente și limite separate, afișate ca două bare de utilizare în partea de sus a paginii Agenți chat:

Agenți chat — agenții OnChat.
Agenți comenzi — agenții comenzi.

Se numără doar agenții activi. Lângă fiecare bară, butonul Mărește limita deschide lista abonamentelor care măresc limita respectivă. Se alege abonamentul dorit, se confirmă comanda și se emite o factură proformă; limita crește după plata proformei (plata cu cardul se confirmă imediat, plata prin ordin de plată se confirmă manual).

[Ecran: pagina Agenți chat cu cele două bare de utilizare și butoanele Mărește limita]

Notă: butoanele Mărește limita și Activează sunt afișate doar administratorilor contului.

Notă: agentul comenzi nu necesită abonamentul BOCP REST API.

Configurare pas cu pas

Setările agentului sunt disponibile doar administratorilor contului.

Se intră în Conectori AI → Agenți chat și se apasă butonul de adăugare.
Se alege tipul Agent comenzi. BOCP creează agentul, inactiv, și creează automat conectorul de comenzi legat de el (un conector de tip BOCP REST API, numit „Agent comenzi #” urmat de numărul agentului, cu confirmare manuală a comenzilor), vizibil și în setările Comenzi eCommerce.
În fereastra agentului se alege Gestiunea din care se raportează stocul. Fără ea, agentul nu poate răspunde la întrebări despre stoc și nu poate plasa comenzi.
La eCommerce connector se alege site-ul în ale cărui comenzi caută agentul: un singur site sau Toate.
Câmpul Conectorul de comenzi (BOCP REST API) prin care agentul plasează comenzi și citește catalogul este deja completat cu conectorul creat la pasul 2 și nu trebuie schimbat.
Se bifează Activ. La activare BOCP verifică limita de agenți comenzi și, pentru conectorul de comenzi legat, limita de conectori eCommerce. Dacă una dintre limite este atinsă, se afișează un mesaj și butonul Mărește limita.
Produsele care trebuie să apară în catalogul agentului se publică pe conectorul de comenzi al agentului, la fel ca pentru orice conector eCommerce.
Se copiază textul din secțiunea Pentru agentul tău AI și se transmite, împreună cu parola, celui care administrează agentul de chat.

[Ecran: fereastra agentului comenzi, cu gestiunea, site-ul, conectorul de comenzi, bifa Activ și caseta Pentru agentul tău AI]

Caseta „Pentru agentul tău AI”

În fereastra agentului, sub datele de acces, caseta Pentru agentul tău AI conține un text gata de copiat cu butonul Copiază instrucțiunile pentru AI. Textul cuprinde adresa agentului, numele de utilizator și indicația ca agentul AI să citească întâi adresa de descriere. Parola nu face parte din text: se ia din datele de acces afișate mai sus și se transmite separat.

Adresa de descriere este un document pe care agentul AI îl citește ca să afle singur tot ce poate face: cum se autentifică, ce întrebări poate pune, ce date primește, valorile posibile ale stadiului comenzii, un exemplu de comandă și cum se verifică notificările primite. Documentul este protejat cu aceeași cheie ca restul agentului, iar fiecare răspuns al BOCP către agent trimite spre el, astfel încât agentul AI se poate orienta singur și după o eroare.

Securitate și date personale

O cheie pentru fiecare agent. Datele de acces ale unui agent funcționează doar pentru acel agent și nu pot citi datele altui agent.
Telefonul trebuie să fie cel al expeditorului verificat. Agentul de chat trimite numărul de telefon al persoanei care scrie, așa cum îl garantează platforma (de exemplu numărul WhatsApp al expeditorului), niciodată un număr tastat în conversație. Răspunderea pentru acest lucru aparține platformei de chat. Numărul este acceptat în orice format uzual (07…, +40…, 0040…, 40…) și se compară cu telefonul de pe comandă.
Cel mult 60 de cereri pe minut pentru fiecare agent. Cererile peste această limită sunt refuzate temporar.
Date care nu se transmit niciodată în răspunsurile la întrebări: valoarea comenzii, numele clientului, adresele de livrare și facturare și identificatorii interni din BOCP. Factura nu se transmite în conversație, ci doar prin email, la adresa clientului din BOCP.
Notificările de evenimente conțin sume. Dacă se folosesc notificări (vezi De știut), acestea includ valori precum totalul facturii și suma ramburs.
Un agent inactiv, șters sau peste limita abonamentului nu mai primește niciun răspuns cu date.

Verificarea clientului la agenții OnChat

La agenții de tip OnChat, opțiunea Cere telefonul sau emailul clientului pentru verificare este bifată implicit la agenții noi. Cu opțiunea bifată, platforma de chat trimite telefonul sau emailul clientului, iar comanda este afișată doar dacă acestea se potrivesc cu persoana de contact sau cu adresa de livrare ori de facturare a comenzii. Fără verificare, oricine poate afla stadiul unei comenzi ghicind numărul ei, de aceea se recomandă păstrarea bifei.

Notă: agentul comenzi verifică întotdeauna telefonul clientului, deci nu are această opțiune.

Dezactivare și ștergere

Prin debifarea Activ, agentul nu mai primește răspunsuri; conectorul de comenzi legat rămâne neschimbat.
Prin Șterge agentul, cheia lui nu mai funcționează, iar conectorul de comenzi creat pentru el se dezactivează și se șterge odată cu agentul.
Conectorul de comenzi al unui agent nu poate fi șters din setările Comenzi eCommerce; acolo apare mesajul că se șterge agentul din Conectori AI → Agenți chat.

Probleme frecvente și soluții

Agentul nu găsește comenzile unui client — se verifică dacă telefonul de pe comandă este același cu numărul de pe care scrie clientul, dacă comanda este mai nouă de 90 de zile și neanulată și dacă site-ul ales la eCommerce connector este cel al comenzii (sau Toate). La prima deschidere a ferestrei agentului, BOCP pregătește în fundal căutarea după telefon pentru comenzile existente; până la finalizare, comenzile mai vechi pot lipsi.
Agentul nu poate răspunde despre stoc — nu este aleasă gestiunea din care se raportează stocul, produsul nu este publicat pe conectorul de comenzi al agentului, sau codul trimis nu este identic cu codul produsului ori cu codul de bare.
Comanda este refuzată cu „produs indisponibil în catalog” — codul trimis nu aparține unui produs publicat pe conectorul de comenzi al agentului. Se publică produsul pe conector sau se corectează codul.
Comanda plasată prin agent nu se procesează — comanda așteaptă confirmarea unui operator în Comenzi eCommerce. Se confirmă comanda, sau administratorul schimbă modul de confirmare pe conectorul agentului.
Retrimiterea facturii este refuzată — pentru comandă nu s-a emis încă factura, sau factura a fost deja retrimisă în ultimele 24 de ore. Dacă în setările contului emailurile cu facturi sunt programate pentru ziua lucrătoare următoare, factura pleacă atunci.
Bifa Activ nu se salvează — este atinsă limita de agenți comenzi sau limita de conectori eCommerce; un administrator al contului folosește butonul Mărește limita afișat sub mesaj.
Agentul primește brusc refuzuri după ce a funcționat — numărul de agenți comenzi activi depășește limita abonamentului (de exemplu după expirarea unui abonament). Se mărește limita sau se dezactivează agenții în plus.
Catalogul sau plasarea comenzilor nu funcționează — agentul nu mai are un conector de comenzi valid legat; se verifică câmpul conectorului de comenzi din fereastra agentului.

De știut

Notă: agentul caută în comenzile din Comenzi eCommerce. Comenzile eMag și cele din magazinul BOCP WebShop nu sunt incluse deocamdată.

Notă: pe orice conector se poate completa Adresă notificare evenimente comenzi (doar adrese https). BOCP trimite acolo evenimentele comenzilor conectorului, semnate cu antetul X-BOCP-Signature pe baza cheii secrete a contului, care se afișează o singură dată. Spre deosebire de răspunsurile la întrebări, notificările includ sume, de exemplu totalul facturii și suma ramburs.

Atenție: obligația de a informa clientul că discută cu un agent automat aparține operatorului platformei de chat. Înainte de punerea în funcțiune se recomandă citirea articolului GDPR și asistenții AI conectați la BOCP: ce trebuie să știi înainte.

Atenție: parola agentului se comunică doar celui care administrează agentul de chat și nu se lipește niciodată într-o conversație.

Vezi și

Was this article helpful?

★ ★ ★ ★ ★