La diferència entre saber i buscar
Hi ha dos tipus de preguntes de clients. El primer tipus és general: Quina és la vostra política de devolucions? Quant triga l'enviament? Envieu a Alemanya? Una base de coneixement ben proveïda les gestiona.
El segon tipus és específic: On és la meva comanda #4521? La versió blava encara hi és? Quant em queda al meu pla aquest mes? Aquestes no viuen a una base de coneixement. Viuen als teus sistemes — la teva gestió de comandes, el teu inventari, la teva facturació — i canvien cada segon.
Un chatbot que només pot gestionar el primer tipus és una PMF glorificada. Un chatbot que també pot gestionar el segon tipus és un assistent. La diferència entre tots dos és l'accés a API.
Per què la bretxa et costa clients
La majoria de "xat amb IA" avui es construeix només sobre una base de coneixement. Pot parafrasejar la teva política d'enviament en disset idiomes, però no pot dir a un client on és el seu paquet real ara mateix. Així que el client pregunta, el bot esquiva, i el client o bé es rendeix o espera que un operador busqui dades que el bot podria haver obtingut en mil·lisegons.
Aquest és el sostre del chatbot. Cada "deixa'm comprovar-ho per tu" és una oportunitat perduda de respondre en segons, al primer missatge, mentre la intenció del client encara és calenta.
El que les connexions API realment fan
A enuchat, una connexió API és un enllaç configurat entre el xat i un dels teus serveis backend. La defineixes una vegada: la URL base, el mètode d'autenticació i un grapat d'endpoints amb els seus paràmetres i com mapejar la resposta.
A partir d'aquell moment, la IA pot cridar aquells endpoints durant una conversa. Quan un visitant pregunta sobre una comanda, la IA extreu el número de comanda, crida el teu endpoint de comanda, llegeix l'estat en directe i el plega a la resposta. El visitant veu una frase: "La teva comanda #4521 es va enviar ahir i s'espera que arribi dijous." Darrere d'aquesta frase, una crida API real va passar.
El client no veu la canonada. Només veu que el xat realment sap.
Cinc mètodes d'autenticació, sense codi personalitzat
La majoria d'APIs que voldries connectar ja utilitzen autenticació estàndard. enuchat n'admet cinc d'origen:
- Cap — per a APIs públiques que no necessiten autenticació
- Clau API — enviada com a capçalera o paràmetre de consulta
- Token Bearer — per a autenticació simple basada en token
- Auth bàsica — per a sistemes heretats
- OAuth 2.0 credencials de client — per a proveïdors moderns com Salesforce, HubSpot o el teu propi servidor OAuth
Per a OAuth 2.0, enuchat gestiona el cicle de vida del token automàticament — l'obté a la primera crida, el guarda fins a la caducitat, el refresca quan cal. Configures les credencials una vegada i te n'oblides. Totes les credencials estan xifrades en repòs amb libsodium i mai apareixen a les respostes de l'API.
Variables, plantilles i mapeig de respostes
Els endpoints es defineixen com a plantilles. Una ruta com /orders/{orderId} o un cos JSON que referencia {customerId} interpola valors de variables de sessió — variables que la IA o una regla estàtica poden establir durant la conversa.
Quan l'API respon, mapeges camps de la resposta JSON de nou a variables de sessió utilitzant notació de punt. data.status es converteix en order_status. data.shipping.eta es converteix en delivery_eta. La IA llavors teixeix aquests valors en una resposta en llenguatge natural — en l'idioma propi del visitant.
Tres patrons que cobreixen la majoria de casos d'ús
A la pràctica, la majoria d'integracions d'API cauen en una de tres formes.
Cerca i resposta
El visitant fa una pregunta que es pot respondre amb una crida API. La regla dispara CALL_API seguit de REPLY_AI. La IA utilitza les dades obtingudes per compondre una resposta basada i contextual. Estat de comanda, saldo de compte, disponibilitat d'habitació, preus actuals, seguiment de paquets — tots encaixen aquí.
Cerca i encamina
La crida API retorna prou informació per decidir què fer a continuació. Un compte d'alt valor s'escala a un agent superior. Una subscripció caducada es dirigeix a facturació. La IA utilitza CALL_API seguit de ASSIGN_TO_OPERATOR per prendre decisions d'encaminament basades en dades reals de clients, no en endevinacions.
Fluxos de múltiples passos
El primer missatge etiqueta la conversa amb SET_VARIABLE, el segon dispara la crida API un cop existeix prou context, i el tercer compon la resposta. Útil quan necessites confirmar la intenció abans de fer ping al teu backend, o quan la cerca de dades depèn d'alguna cosa que el visitant va dir fa dos missatges.
Seguretat integrada
Connectar backends a un widget de xat fa nerviosos alguns equips, i hauria de fer-ho. enuchat envia diverses capes de protecció per defecte:
- Prevenció de SSRF bloqueja crides a localhost, IPs privades i noms d'amfitrió només interns
- Temps d'espera de 5 segons impedeix que una API lenta pengi la conversa
- Aïllament de tenant vol dir que no hi ha fuites de dades entre tenants — els teus endpoints només són visibles per als teus propis widgets
- Botons de prova verifiquen tant la connexió com cada endpoint independentment abans de connectar-los a regles
- Credencials xifrades mai viatgen de tornada al panell en forma clara
El que canvia per als teus clients
El xat passa de "deixa'm trobar algú que pugui comprovar-ho" a "comprovat, aquí tens la resposta" — en qualsevol dels més de 60 idiomes, un diumenge a les 3 del matí, mentre el teu equip de suport dorm. Els clients que haurien abandonat el carro, la comanda o el pla es queden compromesos perquè la resposta arriba mentre encara estan preguntant.
Aquesta és la diferència entre un chatbot i un assistent. I és la diferència que els teus clients realment senten.
Com començar
Si ja tens enuchat configurat, les connexions API viuen sota Configuració → Connexions API. Tria un endpoint que respongui una pregunta que el teu equip escriu cent vegades a la setmana — l'estat de la comanda sol ser el lloc d'inici de més palanca. Configura la connexió, afegeix l'endpoint, connecta'l a una regla i prova-ho una vegada abans de fer-ho viu. Mira la guia de Connexions API per al passeig complet.
Si ets nou a enuchat, registra't a enuchat.com. El nivell gratuït inclou connexions API des del primer dia — sense targeta, sense tarifes per conversa, sense caducitat de prova.
Cinc minuts per connectar el teu primer endpoint. La primera resposta útil sol arribar el mateix dia.