Manual del panel · AUTOMAÇÕES

Conexiones de IA: conectar cada proveedor de IA con la clave de la empresa y elegir el modelo de cada tarea

Conexiones de IA sirve para conectar una sola vez cada proveedor de IA de la empresa, con su propia clave de API, e indicar qué modelo realiza cada tarea de la atención, con respaldo y reglas por tipo de lead. La IA de la plataforma nunca responde en lugar de los modelos de la empresa y no se cobra nada de IA.

Cuándo aparece: Aparece en el grupo Automatizaciones cuando las Conexiones de IA se liberan para la cuenta; la cuenta nueva ya nace con las Automatizaciones activadas, excepto Anuncios. En las cuentas que usaban la IA propia, las conexiones ya registradas llegan solas aquí y la dirección antigua lleva a esta pantalla.

Quién puede usarlo

Rol	Qué ve y qué hace
Propietario	Ve todo, conecta, prueba, cambia la clave y elimina conexiones, elige el modelo de cada tarea y elige qué se guarda de las llamadas.
Administrador	Ve y usa la pantalla como el Propietario, dentro de lo que la cuenta permite cambiar a quien no es propietario.
Agente	No ve el elemento en el menú; quien abre la dirección directa vuelve al "Painel" (Panel).

Pantallas

"Conexões de IA" (Conexiones de IA)

La pantalla Conexiones de IA sirve para conectar los proveedores de IA de la empresa, probar y cambiar las claves, elegir el modelo principal y la reserva de cada tarea y definir qué ocurre cuando los modelos fallan.

Dirección en el panel: /app/automacoes/conexoes · Quién lo usa: Propietario, Administrador

Cómo llegar: Por el menú Automatizaciones › Conexiones de IA. Cada pestaña tiene su propia dirección, y el enlace de los Agentes de la plataforma lleva directo a la pestaña Modelo de cada tarea, ya en el grupo correcto.

Encabezado y pestañas

El título, el botón de conectar y las dos pestañas de la pantalla.

Botones y acciones

"Conectar provedor" (Conectar proveedor): Abre el panel lateral para conectar un proveedor nuevo. En el encabezado, el botón aparece en la pestaña "Conexões" (Conexiones) cuando ya hay al menos una conexión.
"Conexões" (Conexiones): Pestaña con las claves conectadas, el camino ante fallas y la seguridad de los datos. El número al lado es la cantidad de conexiones.
"Modelo de cada tarefa" (Modelo de cada tarea): Pestaña con el modelo principal y la reserva de cada grupo de tareas. El número al lado es la cantidad de grupos.

La frase de arriba recuerda que el costo de uso lo cobra el proveedor, contratado directamente por la empresa.
Las pestañas se mueven con las flechas del teclado, y Home y End van a la primera y a la última.

Aviso de la migración

Aparece una vez, para quienes tenían la IA propia, y desaparece después de descartarlo.

Botones y acciones

"Entendi" (Entendido): Descarta el aviso en este navegador; no vuelve.
"Onde foi parar cada parte da tela antiga" (Dónde quedó cada parte de la pantalla anterior): Abre la lista de adónde fue cada parte de la IA propia: modelos y claves, enrutamiento, qué sucede si los modelos fallan y seguridad, salud de los modelos, uso justo y términos.

El aviso dice cuántas conexiones llegaron solas, con las claves, las pruebas y los modelos.

Pestaña Conexiones: tarjeta de cada conexión

Una línea por proveedor, dirección y clave.

Botones y acciones

"Testar conexão" (Probar conexión): Prueba la clave con el proveedor al instante y avisa si respondió, con el tiempo de respuesta, o si fue rechazada.
"Trocar a chave" (Cambiar la clave): Abre el panel lateral Cambiar la clave. La clave antigua sigue vigente hasta que la nueva pase la prueba.
"Remover" (Quitar): Abre la confirmación para quitar la conexión.

El nombre del proveedor, el apodo (si hay) y la clave enmascarada: solo se ven el comienzo y el final.
La insignia de estado: "Testando…" (Probando…), "Falhou no teste" (Falló la prueba) o "Conectada · testada ‹quando›" (Conectada · probada ‹cuándo›).
Modelos disponibles: una insignia por modelo de la conexión.
Usada por: las tareas y los agentes que usan la conexión, o Ningún agente usa esta conexión aún.
Una conexión con falla muestra La clave fue rechazada por el proveedor. Cámbiela por una nueva.
El recuadro La clave queda cifrada y nunca se muestra de nuevo avisa que la clave no vuelve a aparecer.

Pestaña Conexiones: Si sus modelos fallan

El orden que sigue el mensaje hasta ser respondido; el lead nunca se queda sin respuesta.

Paso 1, El respaldo de la tarea: siempre activo; intenta el modelo de respaldo elegido en la pestaña Modelo de cada tarea, otro modelo de la empresa, preferentemente de otro proveedor.
Paso 2, Su equipo: la conversación va a la cola con el aviso de que los modelos están fuera de servicio.
No hay interruptor: la IA de la plataforma no responde en lugar de los modelos de la empresa y no se cobra nada de IA. Para tener respaldo, conecte un segundo proveedor o elija un modelo de respaldo en cada tarea.

Pestaña Conexiones: Seguridad y datos

Lo que se guarda de las llamadas a los modelos de la empresa.

Campos y filtros

"Só números: tokens e tempo de resposta" (Solo números: tokens y tiempo de respuesta): Guarda solo los números de las llamadas, sin el texto.
"O texto das chamadas, para conferir respostas" (El texto de las llamadas, para revisar respuestas): Guarda el texto de las llamadas para que el equipo revise lo que respondió el modelo. Se guarda hasta que la conversación se anonimice o se elimine.

Panel lateral Conectar proveedor

Registra un proveedor con la clave de la empresa. Prueba antes de guardar.

Campos y filtros

"Provedor" (Proveedor)obligatorio: OpenAI, Anthropic, Google, Azure OpenAI, Amazon Bedrock u Otro compatible con OpenAI.
"Apelido (opcional)" (Alias (opcional)): Un nombre para reconocer la conexión, como principal. Sin apodo, vale el nombre del modelo.
"Endereço do serviço" (Dirección del servicio)obligatorio: Solo para Azure OpenAI y Otro compatible con OpenAI: la dirección https del servicio.
"Primeiro modelo" (Primer modelo)obligatorio: El modelo que se usa primero, escrito como el proveedor lo llama.
"Chave de API" (Clave de API)obligatorio: La clave del proveedor. Queda cifrada y nunca se muestra de nuevo. La pantalla avisa cuando el comienzo de la clave parece ser de otro proveedor, pero permite probarla de todos modos.

Botones y acciones

"Mostrar a chave" (Mostrar la clave): Muestra lo escrito en el campo de la clave; pasa a ser Ocultar la clave.
"Testar e salvar" (Probar y guardar): Prueba la clave con el proveedor y solo la guarda si pasa.
Cancelar: Cierra el panel lateral y borra lo escrito.

Errores del campo: Pegue la clave de API., La clave parece incompleta. Compruebe que la copió entera. e Indique qué modelo usar primero.
Si el proveedor la rechaza, la pantalla muestra su respuesta y pide revisar la clave y el modelo.

Panel lateral Cambiar la clave

El mismo panel lateral, solo con el campo de la clave.

Campos y filtros

"Chave de API" (Clave de API)obligatorio: La clave nueva. Si es rechazada, nada cambia y la antigua sigue vigente.

Botones y acciones

"Testar e salvar" (Probar y guardar): Prueba la clave nueva; si pasa, sustituye a la antigua.

Confirmación Quitar la conexión

Dice quién deja de responder antes de quitar.

Botones y acciones

"Remover a conexão ‹provedor›" (Eliminar la conexión ‹provedor›): Quita la conexión y borra la clave de la bóveda de la plataforma. Sigue vigente en la cuenta del proveedor: revóquela allí, si lo desea.
Cancelar: Cierra sin quitar.

Lista los agentes que usan la conexión y dejan de responder hasta que se elija otra, o dice Ningún agente usa esta conexión.
Si una tarea aún usa un modelo de la conexión, la eliminación se rechaza y la frase del servidor aparece en la confirmación.

Pestaña Modelo de cada tarea: atajos

Rellenan los selectores de una vez. Quedan deshabilitados para quienes no pueden editar.

Botones y acciones

"Usar o mesmo modelo para todo o texto" (Usar el mismo modelo para todo el texto): Copia el modelo de la conversación a las tareas livianas de texto.
"Mais econômico" (Más económico): Elige en cada grupo el modelo de menor precio de entrada informado en la conexión.
"Mais qualidade" (Más calidad): Elige en cada grupo el modelo de mayor precio de entrada informado en la conexión.

La búsqueda no cambia sola con los atajos, porque cambiar el modelo de la búsqueda reindexa la base.

Pestaña Modelo de cada tarea: grupos por capacidad

Seis tarjetas; cada una guarda la ruta de todas las tareas del grupo.

Campos y filtros

"Modelo leve" (Modelo ligero): En el grupo Texto, tareas livianas: el modelo de las tareas cortas de apoyo.
Modelo principal: En el grupo Texto, conversación y auditor: el modelo de la conversación, de la verificación y del seguimiento.
Modelo: En los grupos Lectura de imágenes, Transcripción de audio, Respuesta en audio (voz) y Búsqueda en la base de conocimiento: el modelo de la capacidad. Muestra solo los compatibles de las conexiones.
"Reserva, se o principal falhar" (Respaldo, si el principal falla): El modelo de reserva, siempre de otro proveedor conectado, o Sin reserva. En la búsqueda, la reserva es la búsqueda por palabras, sin modelo.

Botones y acciones

"Testar" (Probar): Prueba el modelo elegido con una muestra de la capacidad y muestra Respondió o Falló la prueba, con el tiempo. El costo de la prueba va a la cuenta de la empresa con el proveedor.
"Reindexar com ‹modelo›" (Reindexar con ‹modelo›): En la búsqueda, después de elegir otro modelo: confirma el cambio y reindexa la base. La búsqueda usa el índice antiguo hasta terminar.
"Manter ‹modelo›" (Mantener ‹modelo›): En la búsqueda, desiste del cambio y se queda con el modelo actual.
"Conectar provedor" (Conectar proveedor): Cuando ninguna conexión tiene la capacidad, abre el panel de conexión. La tarjeta explica qué sucede hoy sin ella (por ejemplo, el audio va al equipo sin el texto).

Los grupos son Texto, tareas livianas; Texto, conversación y auditor; Lectura de imágenes; Transcripción de audio; Respuesta en audio (voz); y Búsqueda en la base de conocimiento.
Debajo del campo de respaldo, una sugerencia indica cómo tener respaldo: elegir un modelo de respaldo o conectar un segundo proveedor; sin respaldo, si el principal falla, la conversación va al equipo.
Si el modelo elegido no pasó la prueba de JSON, la tarjeta avisa que atiende de todos modos, pidiendo el JSON en el texto, y sugiere probar la conexión de nuevo.
Cada tarjeta lista las tareas del grupo; hacer clic en una tarea lleva a los Agentes de la plataforma.
Insignias de capacidad: Texto, Visión, Audio, Voz y Embedding.
Pie de página: las tareas que funcionan por reglas no usan modelo y no cuestan nada.

Pestaña Modelo de cada tarea: Reglas por tipo de lead

Cambian el modelo de la conversación según el tipo de lead; valen de arriba hacia abajo.

Campos y filtros

"Quando a regra vale" (Cuándo se aplica la regla): La condición: perfil ideal, si hay objeción o si la tarjeta tiene la etiqueta.
"Nota mínima do perfil ideal" (Puntaje mínimo del perfil ideal): La nota mínima del perfil ideal para que la regla valga.
"Objeção" (Objeción): Qué objeción dispara la regla.
Etiqueta: Qué etiqueta de la tarjeta dispara la regla.
"Modelo da regra" (Modelo de la regla): El modelo que hace la conversación cuando la regla coincide.

Botones y acciones

"Nova regra" (Nueva regla): Crea una regla al final de la lista, empezando por perfil ideal 80 o más.
"Arrastar para mudar a ordem" (Arrastrar para cambiar el orden): Reordena las reglas, con mouse o teclado; la primera que coincide decide el modelo.
"Remover regra" (Quitar regla): Abre la confirmación ¿Quitar esta regla?; las conversaciones vuelven a seguir la tabla.

Sin modelo conectado, la creación queda bloqueada con Conecte un modelo para crear reglas.
Sin reglas: "Nenhuma regra. Todas as conversas seguem a tabela acima." (Ninguna regla. Todas las conversaciones siguen la tabla de arriba.)

Estados de la pantalla

Cargando: Bloques grises mientras cargan las conexiones y las rutas.
Aún sin datos: Ningún proveedor conectado, con la explicación de que la clave queda cifrada y el botón Conectar proveedor.
Si hay un error: Un aviso de error con el botón de intentar de nuevo; la pantalla vuelve cuando la lectura funciona.
Se rechazó la clave de una conexión: La tarjeta queda resaltada como error con Falló la prueba y el pedido de cambiar la clave.
Ninguna conexión tiene la capacidad de un grupo: La tarjeta dice qué hacer y qué ocurre hoy (por ejemplo, el audio va al equipo sin el texto, o la respuesta va por texto).
La búsqueda se está reindexando: Una barra con el porcentaje; la búsqueda usa el índice antiguo hasta terminar.
La cuenta es revendida: No aparece el aviso de la migración.

Paso a paso

Cómo conectar la clave de un proveedor de IA

Abra Automatizaciones › Conexiones de IA y haga clic en Conectar proveedor.
Elija el proveedor; en los que lo piden, complete la Dirección del servicio.
Si lo desea, dé un apodo y escriba el Primer modelo, como el proveedor lo llama.
Pegue la "Chave de API" (Clave de API) y haga clic en Probar y guardar.
Cuando pase, la conexión aparece en la pestaña "Conexões" (Conexiones) como Conectada.

Cómo cambiar la clave de una conexión sin detener la atención

En la pestaña Conexiones, haga clic en Cambiar la clave en la tarjeta de la conexión.
Pegue la clave nueva y haga clic en Probar y guardar.
La clave antigua sigue vigente hasta que la nueva pase la prueba; si es rechazada, nada cambia.

Cómo elegir el modelo de cada tarea y la reserva

Abra la pestaña Modelo de cada tarea.
En cada grupo, elija el modelo en el selector; se guarda al instante.
En Reserva, si el principal falla, elija un modelo de otro proveedor conectado.
Haga clic en "Testar" (Probar) para comprobar la respuesta.
Para un cambio rápido, use Más económico, Más calidad o Usar el mismo modelo para todo el texto.

Cómo cambiar el modelo de la búsqueda

En la pestaña Modelo de cada tarea, abra el grupo Búsqueda en la base de conocimiento.
Elija el modelo nuevo; la pantalla muestra cuántos fragmentos se reindexarán y el tiempo estimado.
Haga clic en Reindexar con el modelo elegido, o en Mantener para desistir.
Siga la barra; la búsqueda usa el índice antiguo hasta terminar.

Cómo quitar una conexión

Antes, cambie en Modelo de cada tarea los modelos que aún usan la conexión.
En la pestaña "Conexões" (Conexiones), haga clic en "Remover" (Quitar) en la tarjeta.
Compruebe qué agentes dejan de responder y confirme en Quitar la conexión.
Revoque la clave en la cuenta del proveedor, si desea que deje de valer de una vez.

Cómo cambiar el modelo de la conversación para un tipo de lead

En la pestaña Modelo de cada tarea, baje hasta Reglas por tipo de lead y haga clic en "Nova regra" (Nueva regla).
Elija la condición, el detalle (nota, objeción o etiqueta) y el "Modelo da regra" (Modelo de la regla).
Arrastre las reglas al orden deseado: la primera que coincide decide.

Preguntas frecuentes

¿Quién cobra el uso de los modelos conectados?

El proveedor, directamente en la cuenta que la empresa tiene con él. Con una conexión activa, la plataforma no cobra el uso de IA de esos modelos; la IA de la plataforma no responde en lugar de los modelos de la empresa, así que no se cobra nada de IA.

¿Se puede ver la clave después de guardada?

No. Queda cifrada y la pantalla muestra solo el comienzo y el final. Para ver la clave completa, consulte la cuenta en el proveedor.

La clave nueva fue rechazada. ¿Se detiene la atención?

No. La clave antigua sigue vigente hasta que la nueva pase la prueba.

¿Qué pasa si el modelo queda fuera de servicio?

El mensaje intenta el respaldo de la tarea (otro modelo de la empresa) y, sin respaldo, va al equipo con el aviso de que los modelos están fuera de servicio. La IA de la plataforma no responde en su lugar. Para tener respaldo, conecte un segundo proveedor. El lead nunca se queda sin respuesta.

¿Por qué tarda cambiar el modelo de la búsqueda?

Porque la base de conocimiento se reindexa con el modelo nuevo. La búsqueda usa el índice antiguo hasta terminar, sin interrumpir la atención.

¿Adónde fue la pantalla IA propia?

En las cuentas con las Conexiones de IA liberadas, se convirtió en esta pantalla: modelos y claves en la pestaña Conexiones, enrutamiento en la pestaña Modelo de cada tarea, y la dirección antigua lleva aquí.

Guía del Centro de ayuda

"Conexões de IA" (Conexiones de IA)

Conecte cada proveedor de IA una vez y elija qué modelo hace cada tarea. El costo de uso lo cobra su proveedor, contratado directamente por usted.

En "Automações → Conexões de IA" (Automatizaciones → Conexiones de IA) usted conecta los proveedores de IA de su empresa y elige qué modelo hace cada tarea. La pantalla tiene dos pestañas: "Conexões" (Conexiones) y "Modelo de cada tarefa" (Modelo de cada tarea). Quien usaba "IA própria" (IA propia) encuentra todo aquí: las conexiones ya registradas llegaron solas, con las claves, las pruebas y los modelos, y la dirección antigua lo trae a esta pantalla.

"Conexões" (Conexiones)

Conecte un proveedor: Haga clic en "Conectar provedor" (Conectar proveedor), elija el proveedor (OpenAI, Anthropic, Google, Azure OpenAI, Amazon Bedrock u otro compatible con OpenAI), ponga un apodo si quiere, indique el primer modelo y pegue la clave. "Testar e salvar" (Probar y guardar) prueba la clave con el proveedor antes de guardarla.
Si la prueba no pasa: La pantalla muestra lo que respondió el proveedor y avisa cuando la clave parece ser de otro proveedor. En Google, la clave empieza con AIza (con i mayúscula) o, en las claves nuevas, con AQ.: las dos funcionan.
Revise el estado: Cada conexión muestra el inicio y el final de la clave, si está "Conectada" (Conectada) (y cuándo se probó), los modelos disponibles y quién usa la conexión. "Testar conexão" (Probar conexión) vuelve a probar en el momento.
Cambie la clave cuando lo necesite: En "Trocar a chave" (Cambiar la clave), pegue la nueva. La antigua sigue valiendo hasta que la nueva pase la prueba: si la nueva es rechazada, nada cambia.

"Remover" (Quitar) pide confirmación y dice qué agentes usan la conexión y dejan de responder. Mientras una tarea use un modelo de la conexión, cambie el modelo en "Modelo de cada tarefa" (Modelo de cada tarea) antes de quitarla. La clave sale de nuestra bóveda, pero sigue valiendo en su cuenta del proveedor: revóquela allí, si quiere.

Si sus modelos fallan: El mensaje prueba el respaldo de la tarea (otro modelo suyo, elegido en la pestaña Modelo de cada tarea) y, sin respaldo, va a su equipo con el aviso de que los modelos están caídos. La IA de la plataforma no entra en su lugar. Para tener respaldo, conecte un segundo proveedor. El lead nunca se queda sin respuesta.
Una tarea de apoyo sin respuesta: Si solo una tarea de apoyo se queda sin modelo en ese mensaje (la verificación de la respuesta, la intención, la calificación, el sentimiento o la extracción de datos), usa las reglas locales y la respuesta que escribió su modelo sale normalmente. La conversación solo pasa a su equipo cuando es la propia respuesta al lead la que se queda sin modelo.
Qué se cobra: Con una conexión activa, el uso de IA de sus modelos no lo cobra la plataforma: mensajes, leads calientes y tibios, ajuste de la calificación, generación de segmento y de formularios, cadencias, campañas, audios transcritos e imágenes leídas. SMS y correo tampoco se cobran. La IA de la plataforma no responde en lugar de sus modelos, así que no se cobra nada de IA. Las plantillas de Meta siguen en el saldo prepago.
Modelo que no pasó la verificación de JSON: La conversación con el lead funciona con él. La intención y la calificación, que piden la respuesta en un formato fijo, se le piden al mismo modelo como texto; si no acierta el formato, el mensaje sigue el mismo camino que cuando sus modelos fallan. Para el mejor resultado, elija para esas tareas un modelo que pasó la verificación de JSON.
"Segurança e dados" (Seguridad y datos): Elija qué se guarda de las llamadas: solo números (tokens y tiempo de respuesta) o el texto de las llamadas, para revisar respuestas. El texto se guarda hasta que la conversación se anonimice o se elimine.

"Modelo de cada tarefa" (Modelo de cada tarea)

Las tareas de los agentes de la plataforma se agrupan por capacidad: "texto, tarefas leves" (texto, tareas livianas); "texto, conversa e auditor" (texto, conversación y auditor); "leitura de imagem" (lectura de imagen); "transcrição de áudio" (transcripción de audio); "resposta em áudio (voz)" (respuesta en audio (voz)); y "busca na base de conhecimento" (búsqueda en la base de conocimiento). Cada selector muestra solo los modelos compatibles de sus conexiones, y la reserva viene de otro proveedor conectado.

Sí: "Usar o mesmo modelo para todo o texto" (Usar el mismo modelo para todo el texto), "Mais econômico" (Más económico) y "Mais qualidade" (Más calidad) llenan los selectores de una vez.
Sí: Cambiar el modelo de la "busca" (búsqueda) reindexa su base: la pantalla avisa el tamaño y el tiempo, y la búsqueda usa el índice antiguo hasta terminar, con el avance en vivo.
Sí: Cuando ninguna conexión tiene la capacidad, el grupo dice lo que pasa hoy y ofrece "Conectar provedor" (Conectar proveedor). Sin respaldo elegido, la sugerencia debajo del campo propone conectar un segundo proveedor o elegir un modelo de respaldo. Un modelo que no pasó la prueba de JSON sigue valiendo: responde pidiendo el JSON en el texto, y el grupo sugiere probar la conexión de nuevo.
Sí: Cada agente suyo puede cambiar solo el modelo principal y el liviano en el editor; imagen, audio y voz siguen esta pestaña.

En el panel: "Abrir Conexões de IA" (Abrir Conexiones de IA)