Your AI Connector Docs

Biblioteca media

Biblioteca media permite botului tău AI să trimită imagini, videoclipuri, GIF-uri, note vocale și documente PDF unui contact în timpul unei conversații. Încarci fișierele o singură dată, îi spui botului când trebuie trimis fiecare și acesta îl alege pe cel potrivit la momentul oportun - de exemplu, trimițând o fotografie a produsului când cineva întreabă „îl pot vedea?”, o broșură PDF când cineva cere lista completă de prețuri sau o notă vocală rapidă care ghidează clientul prin meniul tău.

Gândește-te la ea ca la un raft cu fișiere gata de trimis pentru botul tău. Tu decizi ce se află pe raft și când este folosit fiecare element.

Biblioteca media este disponibilă implicit pentru fiecare cont.


De ce să folosești o Bibliotecă media

Răspunsurile doar în format text au limitele lor. O fotografie, un videoclip scurt sau o notă vocală răspund adesea la o întrebare mai rapid și mai convingător decât un paragraf de text.

Ce îi permite biblioteca media botului tău să facă:

  • Trimite o fotografie a produsului când un contact cere să vadă ceva
  • Partajează un meniu, o listă de prețuri sau o imagine a produsului sub formă de imagine
  • Trimite un scurt videoclip demonstrativ sau de tip „cum să”
  • Răspunde cu un GIF când se potrivește tonului conversației
  • Trimite o notă vocală sau un clip audio pentru o notă personală, umană
  • Trimite un document PDF - o broșură, o listă de prețuri, un catalog sau un document cu termeni și condiții

Din bibliotecă, botul trimite doar fișierele pe care tu le-ai încărcat și aprobat. Acesta nu inventează niciodată un fișier și nu trimite niciodată un fișier dintr-un link pe care un contact îl lipește. Păstrezi un catalog mare în propriul tău sistem? Consultă Fișiere din propriile tale instrumente.


Unde o poți găsi

În bara laterală principală, sub AI Studio, faceți clic pe Media Library. Această pagină afișează fiecare fișier pe care botul îl poate trimite într-o vizualizare la nivel de cont, grupate astfel încât un fișier utilizat în mai multe locuri să apară ca un singur card. Fiecare element aparține unuia sau mai multor AI Agents — cardul listează cărora. Utilizați filtrul Show din partea de sus pentru a vedea totul sau doar conținutul media al unui singur agent.


Cum decide botul ce să trimită

Aceasta este cea mai importantă parte de configurat corect. Pentru fiecare element pe care îl încarci, scrii o scurtă instrucțiune care descrie când ar trebui botul să îl trimită. Botul citește aceste instrucțiuni și trimite un element doar atunci când situația pe care ai descris-o apare efectiv.

De exemplu:

Articol „Când ar trebui să trimită botul acest lucru?”
Fotografie cu rochia albastră Când un client cere să vadă versiunea albastră sau cum arată
Meniu cină (imagine) Când cineva întreabă ce mâncare serviți sau cere să vadă meniul
Tutorial de configurare (video) Când un client întreabă cum să instaleze sau cum să înceapă

Cu cât instrucțiunea ta este mai clară, cu atât sincronizarea botului va fi mai bună. Instrucțiunile vagi, cum ar fi „trimite când este relevant”, oferă botului mai puține detalii decât „trimite când un client întreabă despre prețul planului premium”.


Cum știe botul ce se află în fiecare fișier

Când încarci un fișier, platforma îl analizează automat și scrie o scurtă descriere a conținutului său - „se uită” la imaginea sau videoclipul tău sau transcrie fișierul audio. Botul folosește acest lucru împreună cu instrucțiunea ta „când să trimită”, astfel încât înțelege atât ce este fișierul, cât și când să îl folosească - chiar dacă propria ta descriere este scurtă. Vei vedea acest rezumat AI pe fiecare element din listă (afișat ca „AI vede: …”).

Nu trebuie să faci nimic pentru acest lucru - se întâmplă la încărcare. Înseamnă doar că un titlu și o instrucțiune clare, plus interpretarea fișierului de către AI, oferă botului cea mai bună șansă de a trimite elementul corect la momentul potrivit.

Corectarea unei transcrieri

Pentru o notă vocală sau un fișier audio, acea descriere este transcrierea: cuvintele rostite în înregistrare. Este, de asemenea, textul afișat sub nota vocală în conversațiile tale după ce botul o trimite. Transcrierea automată înțelege uneori greșit un nume, un brand sau un cuvânt neobișnuit, iar tu poți corecta acest lucru singur.

  1. În Biblioteca ta media sau în fila Media a agentului, dă clic pe element pentru a deschide editorul acestuia.
  2. Găsește câmpul Transcriere. Acesta afișează textul care a fost scris când ai încărcat fișierul.
  3. Corectează cuvintele care au fost înțelese greșit, apoi dă clic pe Salvare.

De atunci înainte, botul citește textul corectat, iar fiecare notă vocală pe care o trimite afișează textul corectat dedesubt. Mesajele care au fost deja trimise păstrează textul cu care au fost trimise.

Bine de știut:

  • Transcrierea este păstrată sub forma unui scurt paragraf de până la 300 de caractere. O înregistrare mai lungă este tăiată la această lungime, așa că păstrează partea care îi spune botului despre ce este vorba în înregistrare.
  • Imaginile, videoclipurile și documentele au același câmp, numit Ce vede botul în acest fișier. Editează-l atunci când descrierea automată este greșită sau omite ceva important.
  • Poți goli câmpul. Botul se va baza atunci doar pe titlul tău și pe instrucțiunea „când să trimită”.
  • Câmpul apare atunci când editezi un element existent. O încărcare nouă începe întotdeauna cu textul automat.

Media în mesaje de follow-up

Unul dintre cele mai utile locuri pentru conținut media este un follow-up - notificarea automată pe care botul o trimite atunci când un contact care a răspuns anterior tace pentru o perioadă. O notă vocală scurtă, un videoclip rapid sau un clip de tipul „mai ești acolo?” reangajează adesea o persoană mult mai bine decât un alt rând de text.

Pentru a-l utiliza, scrie o instrucțiune „când să trimiți” care descrie o situație de follow-up, de exemplu:

Element „Când ar trebui botul să trimită acest lucru?”
Notă vocală de reangajare Când trimiți un follow-up cuiva care a tăcut pentru o perioadă
GIF „Mai ești acolo?” Dacă un contact încetează să mai răspundă în mijlocul conversației

Când sosește acel moment, botul decide dacă unul dintre elementele tale media se potrivește cu follow-up-ul și, dacă da, îl trimite.

Doriți un anumit fișier pentru o anumită etapă de follow-up? O notă de tip „când să trimiți” descrie o situație, astfel încât botul decide când este potrivită; acesta nu știe care este numărul etapei de follow-up care se declanșează. Pentru a trimite nota vocală exact la al doilea memento și imaginea cu prețuri la al treilea, fixați elementele la acei pași în secțiunea Follow-ups a agentului: consultați Atașați un element media la o etapă specifică de follow-up.

Mesajele de follow-up pot conține doar conținut media. Dacă un element este menit să fie de sine stătător - să zicem o notă vocală care spune deja totul - follow-up-ul poate fi doar acel conținut media, fără text. Indică acest lucru în câmpul „Ce ar trebui să spună botul când trimite acest lucru?”, de exemplu „trimite doar nota vocală, nu este nevoie de text”. În caz contrar, botul trimite un scurt text de notificare alături de conținutul media.

Câteva lucruri de știut:

  • Acest lucru funcționează atât pentru follow-up-urile rapide (notificările timpurii), cât și pentru ciclurile de follow-up pe mai multe zile - pe WhatsApp Web, Instagram, Messenger și Telegram.
  • Pe WhatsApp Business API, follow-up-urile media pot fi trimise doar cât timp fereastra de 24 de ore este încă deschisă. După aceea, WhatsApp permite doar șabloane preaprobate, așa că follow-up-urile ulterioare de acolo rămân doar text.
  • Se aplică aceeași limită de trimitere per conversație, deci botul nu va repeta același fișier în cadrul follow-up-urilor, decât dacă mărești limita pentru acel element.

Cum să adaugi conținut media

  1. În bara laterală principală, faceți clic pe AI Studio.
  2. Faceți clic pe Media Library.
  3. Faceți clic pe butonul + Add media.
  1. Sub Adăugare la agenți, bifează agentul/agenții cărora ar trebui să le aparțină elementul. Un element poate fi atașat la mai mult de unul, iar tu poți căuta în listă sau o poți sorta după Recent, Nume sau Live mai întâi.
  2. Dă clic pentru a alege un fișier (imagine, video, GIF, audio sau PDF) de pe dispozitivul tău. Pentru audio, poți de asemenea să comuți la Înregistrare notă vocală și să înregistrezi una direct în aplicație în loc să o încarci. Dacă adaugi audio, poți alege dacă acesta este trimis ca notă vocală (un balon cu voce înregistrată) sau ca un fișier audio obișnuit.
  3. Tastează un Titlu scurt pentru a putea recunoaște elementul mai târziu (de ex. „Fotografie rochie albastră”).
  4. În câmpul Când ar trebui botul să trimită acest lucru?, descrie situația în limbaj simplu.
  1. Dă clic pe Adăugare media. Elementul apare în lista ta media și este disponibil imediat botului pe fiecare agent la care l-ai atașat.

De asemenea, puteți adăuga conținut media din fila Media a unui Agent — aceasta deschide aceeași bibliotecă subiacentă, doar că prefiltrată pentru acel agent. Fila funcționează din momentul în care agentul există, inclusiv pentru unul creat acum un minut sau duplicat de la altul, iar un fișier pe care îl încărcați acolo aparține imediat acelui agent:

Ați încărcat deja un fișier și doriți să îl reutilizați pe un alt agent? În loc să îl încărcați din nou, deschideți elementul și faceți clic pe Assign, apoi alegeți agentul (sau agenții) suplimentar(i). Fișierul în sine nu este duplicat — pur și simplu adăugați un alt agent la același element media.

Ce trebuie să completați

Câmp Ce să scrieți
Fișier Imaginea, videoclipul, GIF-ul, nota audio/vocală sau PDF-ul pe care doriți ca botul să îl poată trimite
Titlu O etichetă scurtă pentru referința dumneavoastră (contactul nu va vedea niciodată acest lucru)
Când ar trebui să trimită botul acest lucru? O descriere clară a situației care ar trebui să declanșeze acest element
Număr maxim de trimiteri per conversație De câte ori poate botul să trimită acest fișier aceluiași contact. Valoarea implicită este 1, astfel încât botul să nu repete același fișier către persoane. Creșteți această valoare dacă un fișier trebuie să poată fi retrimis.
Ce ar trebui să spună botul când trimite acest lucru? Opțional. Un mesaj sugerat pentru momentul în care botul trimite acest element. Botul îl folosește ca îndrumare și îl formulează natural în context (nu îl va citi robotic). Lăsați gol pentru a lăsa botul să decidă. Dacă doriți cuvintele exacte, scrieți ceva de genul „spune exact: Permiteți-mi să vă trimit o scurtă notă vocală.”

Aceste câmpuri sunt note pentru bot, nu mesaje pentru contactul tău

Câmpurile Titlu, Când ar trebui botul să trimită acest lucru? și Ce ar trebui să spună botul când trimite acest lucru? sunt pentru tine, să le scrii în orice limbă gândești. Contactul tău nu le vede niciodată.

Botul scrie întotdeauna fiecărui contact în limba respectivului contact. Așadar, dacă scrii notele în chineză și un contact vorbitor de engleză cere să vadă locația, botul trimite fotografia cu o legendă în engleză bazată pe nota ta. Scrie notele în limba care îți este cea mai ușoară.

Fișiere acceptate și limite

  • Imagini: JPG, PNG, GIF, WebP
  • Video: MP4, MOV, WebM
  • Audio: MP3, OGG, WAV, M4A (trimiteți ca notă vocală sau fișier audio simplu)
  • Documente: PDF
  • Dimensiune maximă: 10 MB per fișier
  • Per agent: până la 50 de elemente

Când încarci un PDF, platforma îi citește textul astfel încât botul să știe ce conține - la fel ca în cazul analizei automate pentru imagini și audio.


Editarea și eliminarea conținutului media

  • Pentru a schimba titlul unui element sau instrucțiunea când să trimită, dă clic pe element și editează câmpurile, apoi salvează. (Editarea instrucțiunii nu necesită reîncărcarea fișierului.)
  • Pentru a corecta o transcriere care a înțeles greșit un cuvânt sau descrierea a ceea ce vede botul într-un fișier, editează acel câmp în același editor. Vezi Corectarea unei transcrieri.
  • Pentru a elimina un element, dă clic pe pictograma de ștergere (coș de gunoi) de pe acesta. Fișierul și instrucțiunea sa sunt eliminate, iar botul nu îl mai trimite.
  • Pentru a înlocui fișierul în sine, șterge elementul și adaugă unul nou.

Ce canale pot primi conținut media

Majoritatea canalelor pot primi conținut media, dar nu toate:

Canal Suport media
WhatsApp (Business & Web) Imagini, video, GIF, note vocale, audio, documente PDF
Facebook Messenger Imagini, video, note vocale, audio, documente PDF
Instagram Imagini, video, note vocale
Telegram Imagini, video, audio (ca fișier, nu ca notă vocală), documente PDF
LINE Doar imagini
SMS Neacceptat (doar text)

Câteva aspecte de reținut:

  • SMS-urile nu pot primi conținut media. În conversațiile prin SMS, botul pur și simplu nu va oferi elemente media.
  • Instagram nu poate primi documente. Într-o conversație pe Instagram, botul nu va trimite fișiere PDF - în schimb, va răspunde prin text.
  • GIF-urile sunt optimizate automat atunci când le încărcați, astfel încât să fie animate pe WhatsApp. Pe alte canale, un GIF poate apărea ca o imagine statică.
  • Fereastra de 24 de ore a WhatsApp se aplică și conținutului media. Dacă a trecut prea mult timp de când contactul v-a trimis ultimul mesaj, WhatsApp poate bloca orice mesaj - inclusiv conținutul media - până când acesta răspunde din nou.

Sfaturi pentru cele mai bune rezultate

  1. Scrie instrucțiunea „când să trimiți” ca și cum ai instrui un nou membru al echipei. Descrie momentul exact - „când un client cere să vadă fotografii cu apartamentul” - nu doar subiectul.
  2. Un singur scop per element. Încarcă elemente separate pentru situații diferite, în loc de un singur fișier despre care speri că acoperă totul.
  3. Păstrează fișierele mici și rapide la încărcare. O imagine comprimată sau un clip scurt ajunge mai repede și arată mai bine în chat decât un fișier uriaș.
  4. Folosește titluri clare și ușor de recunoscut. Pe măsură ce biblioteca ta crește, titlurile bune fac ușoară găsirea și actualizarea elementului potrivit.
  5. Testează în Try Out. După adăugarea conținutului media, folosește fila Try Out a Agentului pentru a verifica dacă botul alege elementul potrivit la momentul potrivit înainte de a trece la varianta live. Imaginea, videoclipul, fișierul audio sau documentul apar direct în chat-ul de test, exact acolo unde contactul le-ar primi.

Conversațiile de test mai vechi pot afișa „Previzualizarea media a expirat”. Chat-ul de test este un sandbox - niciun mesaj real nu părăsește contul tău - iar previzualizările media rămân vizibile timp de 7 zile. Dacă revii ulterior la o conversație de test veche, o previzualizare expirată va afișa în schimb o mică notă; pur și simplu cere-i botului din nou să o afișeze. Conversațiile reale nu sunt afectate: contactele primesc fișierul propriu-zis, care nu expiră.

Mai multe fișiere pentru același lucru. În mod normal, botul alege singurul element cel mai potrivit pentru momentul respectiv, așa că cinci fotografii cu aceeași notă „Când ar trebui să trimită botul acest lucru?” înseamnă, de obicei, că va fi trimisă o singură fotografie. Dacă un set aparține aceluiași grup (toate fotografiile unui produs, un meniu complet), specificați acest lucru în instrucțiunile agentului, de exemplu „Când cineva întreabă despre scaunul de grădină, trimite toate fotografiile cu scaunul de grădină” și adăugați fiecărei fotografii o notă care denumește produsul. Botul va trimite apoi întregul set într-un singur răspuns.

Botul nu va trimite spam cu același fișier. Fiecare element este trimis cel mult o dată per conversație în mod implicit. Dacă un client continuă să întrebe despre același lucru, botul va răspunde prin text în loc să trimită din nou aceeași imagine. Creșteți valoarea „Număr maxim de trimiteri per conversație” pentru un element dacă doriți cu adevărat ca acesta să poată fi retrimis.


Fișiere din propriile tale instrumente

O bibliotecă poate conține până la 50 de elemente per agent. Dacă fotografiile produselor tale, meniurile sau fișele tehnice se află deja în propriul tău sistem (o bază de date, un magazin, un CRM), nu trebuie să le încarci aici. Conectează acel sistem la agent ca o Funcție personalizată sau un server MCP care returnează un link direct către fișier, iar botul va trimite fișierul propriu-zis în loc să lipească linkul.

Cum funcționează:

  1. Contactul cere ceva, de exemplu „pot vedea uleiul de măsline?”
  2. Botul apelează instrumentul tău, iar rezultatul conține un link către fișier, cum ar fi https://yourstore.com/images/olive-oil.jpg
  3. Botul trimite acel fișier contactului sub formă de imagine, video, fișier audio sau document real, cu o scurtă descriere în limba contactului

Ce trebuie să fie linkul:

  • Un link direct către fișier care începe cu https://. Un link către o pagină web (o pagină de produs) nu este un fișier; botul îl va partaja ca pe un link normal.
  • Imagini: JPG, PNG, WebP, GIF. Video: MP4, MOV, WebM, 3GP. Audio: MP3, OGG, M4A, AAC, WAV. Documente: PDF, Word, Excel, PowerPoint, CSV
  • Până la 16 MB per fișier
  • Accesibil fără autentificare. Un link care necesită o parolă sau care a expirat deja nu poate fi trimis.

Bine de știut:

  • Botul trimite doar linkurile care au fost returnate de propriile tale instrumente în acea conversație. Un link tastat de un contact sau unul pe care botul l-ar inventa nu este trimis niciodată ca fișier.
  • Fișierul este copiat atunci când este trimis, astfel încât contactul îl păstrează chiar dacă linkul tău expiră ulterior.
  • Fiecare link de fișier este trimis cel mult o dată per conversație.
  • Se aplică aceleași limite de canal ca și pentru elementele din bibliotecă, consultă Ce canale pot primi conținut media.
  • În fila Try Out a agentului, fișierul apare în chatul de test și nu este trimis nimănui.

Trimiterea manuală a conținutului media

Biblioteca media este destinată trimiterilor automate ale botului. Puteți oricând să trimiteți manual orice imagine, videoclip sau fișier unui contact din Interfața de chat în orice moment - acest lucru nu necesită configurarea unui element în bibliotecă.


Pașii următori

  • Agenți AI — fila Media din interiorul editorului fiecărui Agent.
  • Agenți AI — pagina principală a grupului AI Studio, alături de Baza de cunoștințe și Funcțiile personalizate.
  • Follow-up-uri automate — ghidul complet pentru secvențele de follow-up la care pot fi atașate fișiere media.