Manual do painel · AUTOMAÇÕES

Conexões de IA: conectar cada provedor de IA com a chave da empresa e escolher o modelo de cada tarefa

Conexões de IA serve para conectar uma vez cada provedor de IA da empresa, com a chave de API dela, e dizer qual modelo faz cada tarefa do atendimento, com reserva e regras por tipo de lead. A IA da plataforma nunca responde no lugar dos modelos da empresa e nada da IA é cobrado.

Quando aparece: Aparece no grupo Automações quando as Conexões de IA são liberadas para a conta; a conta nova já nasce com as Automações ligadas, exceto Anúncios. Nas contas que usavam a IA própria, as conexões já cadastradas vêm sozinhas para cá e o endereço antigo leva a esta tela.

Quem pode usar

Papel	O que vê e faz
Dono	Vê tudo, conecta, testa, troca a chave e remove conexões, escolhe o modelo de cada tarefa e escolhe o que fica guardado das chamadas.
Admin	Vê e usa a tela como o dono, dentro do que a conta permite mudar a quem não é dono.
Atendente	Não vê o item no menu; quem abre o endereço direto volta para o Painel.

Telas

Conexões de IA

A tela Conexões de IA serve para conectar os provedores de IA da empresa, testar e trocar as chaves, escolher o modelo principal e a reserva de cada tarefa e definir o que acontece quando os modelos falham.

Endereço no painel: /app/automacoes/conexoes · Quem usa: Dono, Admin

Como chegar: Pelo menu Automações › Conexões de IA. Cada aba tem endereço próprio, e o link dos Agentes da plataforma leva direto à aba Modelo de cada tarefa, já no grupo certo.

Cabeçalho e abas

O título, o botão de conectar e as duas abas da tela.

Botões e ações

Conectar provedor: Abre a gaveta para conectar um provedor novo. No cabeçalho, o botão aparece na aba Conexões quando já há pelo menos uma conexão.
Conexões: Aba com as chaves conectadas, o caminho da falha e a segurança dos dados. O número ao lado é a quantidade de conexões.
Modelo de cada tarefa: Aba com o modelo principal e a reserva de cada grupo de tarefas. O número ao lado é a quantidade de grupos.

A frase do topo lembra que o custo de uso é cobrado pelo provedor, contratado direto pela empresa.
As abas se movem com as setas do teclado, e Home e End vão à primeira e à última.

Aviso da migração

Aparece uma vez, para quem tinha a IA própria, e some depois de dispensado.

Botões e ações

Entendi: Dispensa o aviso neste navegador; ele não volta.
Onde foi parar cada parte da tela antiga: Abre a lista de onde foi cada parte da IA própria: modelos e chaves, roteamento, o que acontece se os modelos falharem e segurança, saúde dos modelos, uso justo e termos.

O aviso diz quantas conexões vieram sozinhas, com as chaves, os testes e os modelos.

Aba Conexões: cartão de cada conexão

Uma linha por provedor, endereço e chave.

Botões e ações

Testar conexão: Testa a chave no provedor na hora e avisa se respondeu, com o tempo de resposta, ou se foi recusada.
Trocar a chave: Abre a gaveta Trocar a chave. A chave antiga vale até a nova passar no teste.
Remover: Abre a confirmação para remover a conexão.

O nome do provedor, o apelido (se houver) e a chave mascarada: só o começo e o fim aparecem.
O selo de situação: Testando…, Falhou no teste ou Conectada · testada ‹quando›.
Modelos disponíveis: um selo por modelo da conexão.
Usada por: as tarefas e os agentes que usam a conexão, ou Nenhum agente usa esta conexão ainda.
Conexão com falha mostra A chave foi recusada pelo provedor. Troque por uma nova.
O quadro A chave fica cifrada e nunca é mostrada de novo avisa que a chave não volta a aparecer.

Aba Conexões: Se os seus modelos falharem

A ordem que a mensagem segue até ser respondida; o lead nunca fica sem resposta.

Passo 1, A reserva da tarefa: sempre ligado; tenta o modelo de reserva escolhido na aba Modelo de cada tarefa, outro modelo da empresa, de preferência de outro provedor.
Passo 2, A sua equipe: a conversa vai para a fila com o aviso de que os modelos estão fora.
Não há interruptor: a IA da plataforma não responde no lugar dos modelos da empresa, e nada da IA é cobrado. Para ter reserva, conecte um segundo provedor ou escolha um modelo de reserva em cada tarefa.

Aba Conexões: Segurança e dados

O que fica guardado das chamadas aos modelos da empresa.

Campos e filtros

Só números: tokens e tempo de resposta: Guarda apenas os números das chamadas, sem o texto.
O texto das chamadas, por 30 dias, para conferir respostas: Guarda o texto das chamadas por 30 dias para a equipe conferir o que o modelo respondeu.

Gaveta Conectar provedor

Cadastra um provedor com a chave da empresa. Testa antes de salvar.

Campos e filtros

Provedorobrigatório: OpenAI, Anthropic, Google, Azure OpenAI, Amazon Bedrock ou Outro compatível com OpenAI.
Apelido (opcional): Um nome para reconhecer a conexão, como principal. Sem apelido, vale o nome do modelo.
Endereço do serviçoobrigatório: Só para Azure OpenAI e Outro compatível com OpenAI: o endereço https do serviço.
Primeiro modeloobrigatório: O modelo a usar primeiro, escrito como o provedor o chama.
Chave de APIobrigatório: A chave do provedor. Fica cifrada e nunca é mostrada de novo. A tela avisa quando o começo da chave parece ser de outro provedor, mas deixa testar assim mesmo.

Botões e ações

Mostrar a chave: Mostra o que foi digitado no campo da chave; vira Esconder a chave.
Testar e salvar: Testa a chave no provedor e só guarda se passar.
Cancelar: Fecha a gaveta e apaga o que foi digitado.

Erros do campo: Cole a chave de API., A chave parece incompleta. Confira se copiou inteira. e Diga qual modelo usar primeiro.
Se o provedor recusa, a tela mostra a resposta dele e pede para conferir a chave e o modelo.

Gaveta Trocar a chave

A mesma gaveta, só com o campo da chave.

Campos e filtros

Chave de APIobrigatório: A chave nova. Se for recusada, nada muda e a antiga segue valendo.

Botões e ações

Testar e salvar: Testa a chave nova; passando, ela substitui a antiga.

Confirmação Remover a conexão

Diz quem para de responder antes de remover.

Botões e ações

Remover a conexão ‹provedor›: Remove a conexão e apaga a chave do cofre da plataforma. Ela continua valendo na conta do provedor: revogue lá, se quiser.
Cancelar: Fecha sem remover.

Lista os agentes que usam a conexão e param de responder até outra ser escolhida, ou diz Nenhum agente usa esta conexão.
Se uma tarefa ainda usa um modelo da conexão, a remoção é recusada e a frase do servidor aparece na confirmação.

Aba Modelo de cada tarefa: atalhos

Preenchem os seletores de uma vez. Ficam desabilitados para quem não pode editar.

Botões e ações

Usar o mesmo modelo para todo o texto: Copia o modelo da conversa para as tarefas leves de texto.
Mais econômico: Escolhe em cada grupo o modelo de menor preço de entrada informado na conexão.
Mais qualidade: Escolhe em cada grupo o modelo de maior preço de entrada informado na conexão.

A busca não muda sozinha pelos atalhos, porque trocar o modelo da busca reindexa a base.

Aba Modelo de cada tarefa: grupos por capacidade

Seis cartões; cada um grava a rota de todas as tarefas do grupo.

Campos e filtros

Modelo leve: No grupo Texto, tarefas leves: o modelo das tarefas curtas de apoio.
Modelo principal: No grupo Texto, conversa e auditor: o modelo da conversa, da conferência e do follow-up.
Modelo: Nos grupos Leitura de imagem, Transcrição de áudio, Resposta em áudio (voz) e Busca na base de conhecimento: o modelo da capacidade. Mostra só os compatíveis das conexões.
Reserva, se o principal falhar: O modelo de reserva, sempre de outro provedor conectado, ou Sem reserva. Na busca, a reserva é a busca por palavras, sem modelo.

Botões e ações

Testar: Testa o modelo escolhido com uma amostra da capacidade e mostra Respondeu ou Falhou no teste, com o tempo. O custo do teste vai para a conta da empresa no provedor.
Reindexar com ‹modelo›: Na busca, depois de escolher outro modelo: confirma a troca e reindexa a base. A busca usa o índice antigo até terminar.
Manter ‹modelo›: Na busca, desiste da troca e fica com o modelo atual.
Conectar provedor: Quando nenhuma conexão tem a capacidade, abre a gaveta de conexão. O cartão explica o que acontece hoje sem ela (por exemplo, o áudio vai para a equipe sem o texto).

Os grupos são Texto, tarefas leves; Texto, conversa e auditor; Leitura de imagem; Transcrição de áudio; Resposta em áudio (voz); e Busca na base de conhecimento.
Embaixo do campo de reserva, uma dica diz como ter reserva: escolher um modelo de reserva ou conectar um segundo provedor; sem reserva, se o principal falhar, a conversa vai para a equipe.
Se o modelo escolhido não passou no teste de JSON, o cartão avisa que ele atende assim mesmo, pedindo o JSON no texto, e sugere testar a conexão de novo.
Cada cartão lista as tarefas do grupo; clicar numa tarefa leva aos Agentes da plataforma.
Selos de capacidade: Texto, Visão, Áudio, Voz e Embedding.
Rodapé: as tarefas que funcionam por regras não usam modelo e não custam nada.

Aba Modelo de cada tarefa: Regras por tipo de lead

Trocam o modelo da conversa conforme o tipo de lead; valem de cima para baixo.

Campos e filtros

Quando a regra vale: A condição: o perfil ideal, houver objeção ou o cartão tiver a etiqueta.
Nota mínima do perfil ideal: A nota mínima do perfil ideal para a regra valer.
Objeção: Qual objeção dispara a regra.
Etiqueta: Qual etiqueta do cartão dispara a regra.
Modelo da regra: O modelo que faz a conversa quando a regra bate.

Botões e ações

Nova regra: Cria uma regra no fim da lista, começando por perfil ideal 80 ou mais.
Arrastar para mudar a ordem: Reordena as regras, com mouse ou teclado; a primeira que bater decide o modelo.
Remover regra: Abre a confirmação Remover esta regra?; as conversas voltam a seguir a tabela.

Sem modelo conectado, a criação fica travada com Conecte um modelo para criar regras.
Sem regras: Nenhuma regra. Todas as conversas seguem a tabela acima.

Estados da tela

Carregando: Blocos em cinza enquanto as conexões e as rotas carregam.
Sem nada ainda: Nenhum provedor conectado, com a explicação de que a chave fica cifrada e o botão Conectar provedor.
Se der erro: Um aviso de erro com o botão de tentar de novo; a tela volta quando a leitura passa.
A chave de uma conexão foi recusada: O cartão fica em destaque de erro com Falhou no teste e o pedido de trocar a chave.
Nenhuma conexão tem a capacidade de um grupo: O cartão diz o que fazer e o que acontece hoje (por exemplo, o áudio vai para a equipe sem o texto, ou a resposta vai por texto).
A busca está reindexando: Uma barra com a porcentagem; a busca usa o índice antigo até terminar.
A conta é revendida: Não há o aviso da migração.

Passo a passo

Como conectar a chave de um provedor de IA

Abra Automações › Conexões de IA e clique em Conectar provedor.
Escolha o provedor; nos que pedem, preencha o Endereço do serviço.
Se quiser, dê um apelido e escreva o Primeiro modelo, como o provedor o chama.
Cole a Chave de API e clique em Testar e salvar.
Quando passar, a conexão aparece na aba Conexões como Conectada.

Como trocar a chave de uma conexão sem parar o atendimento

Na aba Conexões, clique em Trocar a chave no cartão da conexão.
Cole a chave nova e clique em Testar e salvar.
A chave antiga continua valendo até a nova passar no teste; se for recusada, nada muda.

Como escolher o modelo de cada tarefa e a reserva

Abra a aba Modelo de cada tarefa.
Em cada grupo, escolha o modelo no seletor; ele grava na hora.
Em Reserva, se o principal falhar, escolha um modelo de outro provedor conectado.
Clique em Testar para conferir a resposta.
Para uma troca rápida, use Mais econômico, Mais qualidade ou Usar o mesmo modelo para todo o texto.

Como trocar o modelo da busca

Na aba Modelo de cada tarefa, abra o grupo Busca na base de conhecimento.
Escolha o novo modelo; a tela mostra quantos trechos serão reindexados e o tempo estimado.
Clique em Reindexar com o modelo escolhido, ou em Manter para desistir.
Acompanhe a barra; a busca usa o índice antigo até terminar.

Como remover uma conexão

Antes, troque em Modelo de cada tarefa os modelos que ainda usam a conexão.
Na aba Conexões, clique em Remover no cartão.
Confira quais agentes param de responder e confirme em Remover a conexão.
Revogue a chave na conta do provedor, se quiser que ela deixe de valer de vez.

Como mudar o modelo da conversa para um tipo de lead

Na aba Modelo de cada tarefa, desça até Regras por tipo de lead e clique em Nova regra.
Escolha a condição, o detalhe (nota, objeção ou etiqueta) e o Modelo da regra.
Arraste as regras para a ordem desejada: a primeira que bater decide.

Perguntas frequentes

Quem cobra o uso dos modelos conectados?

O provedor, direto na conta que a empresa tem com ele. Com uma conexão ativa, o uso de IA feito por esses modelos não é cobrado pela plataforma; a IA da plataforma não responde no lugar dos modelos da empresa, então nada de IA é cobrado.

A chave pode ser vista depois de salva?

Não. Ela fica cifrada e a tela mostra só o começo e o fim. Para ver a chave inteira, consulte a conta no provedor.

A chave nova foi recusada. O atendimento para?

Não. A chave antiga continua valendo até a nova passar no teste.

O que acontece se o modelo ficar fora do ar?

A mensagem tenta a reserva da tarefa (outro modelo da empresa) e, sem reserva, vai para a equipe com o aviso de que os modelos estão fora. A IA da plataforma não responde no lugar. Para ter reserva, conecte um segundo provedor. O lead nunca fica sem resposta.

Por que trocar o modelo da busca demora?

Porque a base de conhecimento é reindexada com o modelo novo. A busca usa o índice antigo até terminar, sem interromper o atendimento.

Onde foi a tela IA própria?

Nas contas com as Conexões de IA liberadas, ela virou esta tela: modelos e chaves na aba Conexões, roteamento na aba Modelo de cada tarefa, e o endereço antigo leva para cá.

Guia da Central de ajuda

Conexões de IA

Conecte cada provedor de IA uma vez e diga qual modelo faz cada tarefa. O custo de uso é cobrado pelo seu provedor, contratado direto por você.

Em Automações → Conexões de IA você conecta os provedores de IA da sua empresa e escolhe qual modelo faz cada tarefa. A tela tem duas abas: Conexões e Modelo de cada tarefa. Quem usava a IA própria encontra tudo aqui: as conexões já cadastradas vieram sozinhas, com as chaves, os testes e os modelos, e o endereço antigo traz para esta tela.

Conexões

Conecte um provedor: Clique em Conectar provedor, escolha o provedor (OpenAI, Anthropic, Google, Azure OpenAI, Amazon Bedrock ou outro compatível com OpenAI), dê um apelido se quiser, diga o primeiro modelo e cole a chave. Testar e salvar testa a chave no provedor antes de guardar.
Se o teste não passar: A tela mostra o que o provedor respondeu e avisa quando a chave parece ser de outro provedor. No Google, a chave começa com AIza (com i maiúsculo) ou, nas chaves novas, com AQ.: as duas funcionam.
Confira o estado: Cada conexão mostra o começo e o fim da chave, se está Conectada (e quando foi testada), os modelos disponíveis e quem usa a conexão. Testar conexão testa de novo na hora.
Troque a chave quando precisar: Em Trocar a chave, cole a nova. A antiga continua valendo até a nova passar no teste: se a nova for recusada, nada muda.

Remover pede confirmação e diz quais agentes usam a conexão e param de responder. Enquanto uma tarefa usa um modelo da conexão, troque o modelo em Modelo de cada tarefa antes de remover. A chave sai do nosso cofre, mas continua valendo na sua conta do provedor: revogue lá, se quiser.

Se os seus modelos falharem: A mensagem tenta a reserva da tarefa (outro modelo seu, escolhido na aba Modelo de cada tarefa) e, sem reserva, vai para a sua equipe com o aviso de que os modelos estão fora. A IA da plataforma não entra no lugar. Para ter reserva, conecte um segundo provedor. O lead nunca fica sem resposta.
Uma tarefa de apoio sem resposta: Se só uma tarefa de apoio fica sem modelo naquela mensagem — a conferência, a intenção, a qualificação, o sentimento ou a extração de dados —, ela usa as regras locais e a resposta que o seu modelo escreveu sai normalmente. A conversa só vai para a sua equipe quando é a própria resposta ao lead que fica sem modelo.
O que é cobrado: Com uma conexão ativa, o uso de IA feito pelos seus modelos não é cobrado pela plataforma: mensagens, leads quentes e mornos, ajuste da qualificação, geração de segmento e de formulários, cadências, campanhas, áudios transcritos e imagens lidas. SMS e e-mail também não são cobrados. A IA da plataforma não responde no lugar dos seus modelos, então nada de IA é cobrado. Os modelos da Meta seguem no saldo pré-pago.
Modelo que não passou no JSON: A conversa com o lead funciona com ele. A intenção e a qualificação, que pedem a resposta num formato fixo, são pedidas ao mesmo modelo por texto; se ele não acertar o formato, a mensagem segue o caminho de quando os modelos falham. Para o melhor resultado, escolha para essas tarefas um modelo que passou na checagem de JSON.
Segurança e dados: Escolha o que fica guardado das chamadas: só números (tokens e tempo de resposta) ou o texto das chamadas por 30 dias, para conferir respostas.

Modelo de cada tarefa

As tarefas dos agentes da plataforma ficam agrupadas por capacidade: texto, tarefas leves; texto, conversa e auditor; leitura de imagem; transcrição de áudio; resposta em áudio (voz); e busca na base de conhecimento. Cada seletor mostra só os modelos compatíveis das suas conexões, e a reserva vem de outro provedor conectado.

Sim: Usar o mesmo modelo para todo o texto, Mais econômico e Mais qualidade preenchem os seletores de uma vez.
Sim: Trocar o modelo da busca reindexa a sua base: a tela avisa o tamanho e o tempo, e a busca usa o índice antigo até terminar, com o andamento ao vivo.
Sim: Quando nenhuma conexão tem a capacidade, o grupo diz o que acontece hoje e oferece Conectar provedor. Sem reserva escolhida, a dica embaixo do campo sugere conectar um segundo provedor ou escolher um modelo de reserva. Um modelo que não passou no teste de JSON continua valendo: ele atende pedindo o JSON no texto, e o grupo sugere testar a conexão de novo.
Sim: Cada agente seu pode trocar só o modelo principal e o leve no editor; imagem, áudio e voz seguem esta aba.

No painel: Abrir Conexões de IA