> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Encuadrado > Como conectar a sua agenda clínica do Encuadrado a um agente do ChatNorris para que ele consulte a disponibilidade real e crie reservas verificadas, e como configurar os serviços, a disponibilidade e os dados pedidos ao paciente. # Encuadrado Com a integração do Encuadrado, o seu agente do ChatNorris atende os pacientes da sua agenda clínica sem que eles saiam do chat. De acordo com o que você ativar, o agente: * identifica qual serviço interessa ao paciente; * consulta os horários reais disponíveis na sua agenda e os propõe; * coleta os dados que a reserva exige, mostra um resumo e, só depois que o paciente **confirma explicitamente**, cria a reserva. Ele nunca reserva automaticamente no meio da conversa. Funciona no widget web, WhatsApp, Instagram, Messenger, Telegram, Email e na API. ## Requisitos * Uma conta do ChatNorris com plano **Standard** ou **Premium**. Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing). * Pelo menos um agente criado no ChatNorris. Se você ainda não tiver um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md). * Uma conta do Encuadrado e a API key do profissional. * Função **Owner** ou **Admin** na sua organização do ChatNorris. ## Conectar o Encuadrado Cada agente se conecta a uma conta do Encuadrado. **1. Abra o hub de Integrações do agente** No ChatNorris, acesse `Agentes → [seu agente] → Integrações` e escolha **Encuadrado**. **2. Cole a API key e conecte** Cole a sua API key do Encuadrado em **API key** e clique em **Conectar**. **3. Teste a conexão** Use **Testar conexão** para confirmar que a chave funciona antes de configurar a Ação. A API key é salva criptografada e nunca é mostrada em texto simples. Se você trocar a chave no Encuadrado, cole a nova com **Substituir chave**. ## Configurar a Ação Conectar a conta ainda não ativa nada. Para escolher o que o agente faz: **1. Crie a Ação Encuadrado** Acesse `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **Encuadrado**. A seção **Conta do Encuadrado** mostra o status da conexão. **2. Escolha o que ele pode fazer** Em **O que pode fazer**, ative os recursos (veja a tabela abaixo). **3. Configure os serviços e a disponibilidade** Defina quais serviços da sua agenda o agente pode oferecer e quantos dias e horários ele procura (veja mais abaixo). **4. Ative a Ação e salve** Com **Habilitada** ligada, o agente usa a sua agenda nas conversas. | Recurso | O que faz | | - | - | | **Consultar disponibilidade** | Consulta horários reais e os propõe ao paciente. Vem ativado. | | **Criar reservas** | Coleta dados, pede confirmação explícita e cria a reserva. Requer **Consultar disponibilidade**. | Sem **Criar reservas**, o agente só oferece horários e o link público do serviço para que o paciente reserve por conta própria, e não pede dados pessoais. > [!WARNING] > > **Criar reservas** cria agendamentos reais na clínica: verifique os dados configurados antes de ativá-lo. **Recomenda-se Claude Sonnet ou superior** como modelo principal do agente (`Configurações → IA`) quando você ativa esse recurso. Em testes, o Haiku às vezes ignora a confirmação e responde como se a reserva já estivesse feita. O formulário da ação mostra esse aviso com um link para a configuração de IA. ### Quando usar Em **Comportamento**, o campo **Quando usar esta ação** traz um texto padrão que você pode adaptar: quando o paciente quer saber horários ou agendar, e que primeiro se identifica o serviço. Com **Restaurar texto padrão**, você volta ao original. ### Serviços Adicione em **Serviços** cada serviço que o agente pode oferecer. Cada um precisa do seu **UUID do serviço** no Encuadrado, que você obtém na URL ao editar o serviço no painel do Encuadrado. | Campo | Para que serve | | - | - | | **Nome** e **Descrição** | Como o agente identifica e apresenta o serviço. | | **UUID do serviço** | O identificador do serviço no Encuadrado. Sem ele, o serviço não pode ser consultado. | | **Duração (min)** | Quanto dura o compromisso. | | **Modalidade** | **Online**, **Presencial** ou **A domicílio**. | | **Preço** | O preço que o agente informa. | | **Link público** | A página de reservas do serviço. O agente a oferece quando não consegue confirmar um horário ou quando a data está fora do intervalo de busca. | | **Nome do profissional** | Quem atende o serviço. | | **Emite boleta eletrônica** | O serviço emite boleta: a reserva pede também endereço e comuna. | | **Requer pré-pagamento** | O paciente precisa pagar para confirmar o horário. | | **Habilitado** | Se o agente pode oferecer este serviço. | Com **Novos serviços emitem boleta por padrão** e **Novos serviços requerem pré-pagamento por padrão**, você escolhe como começa cada serviço que adicionar. > [!NOTE] > > Para serviços que emitem boleta, o agente valida a comuna do paciente na lista oficial. As reservas respeitam o fuso horário do Chile (`America/Santiago`). Em um serviço com pré-pagamento, o horário fica reservado temporariamente: o agente informa ao paciente o link de pagamento e o prazo para pagar, e não diz que o compromisso foi agendado. Se ele não pagar a tempo, a vaga é liberada. ### Disponibilidade | Opção | O que faz | | - | - | | **Dias de busca** | Até quantos dias a partir de hoje o agente procura horários (1 a 60; por padrão, 14). | | **Horários oferecidos** | Quantos horários ele propõe de uma vez (1 a 10; por padrão, 3). | Se o paciente pedir uma data mais distante que **Dias de busca**, ou se não houver horários nesse intervalo, o agente explica isso e oferece os horários mais próximos ou o link público do serviço. ### Dados obrigatórios da conta Estes dados são pedidos em toda reserva, além dos que cada serviço exigir (boleta → endereço e comuna): | Dado | Detalhe | | - | - | | **Email** | Obrigatório para confirmar a reserva. Vem ativado. | | **Telefone** | É salvo apenas como hash. | | **RUT** | É usado só para a reserva; nunca é salvo. | | **Data de nascimento** | É usada só para a reserva; nunca é salva. | | **Termos e condições** | Requer aceitação explícita do paciente. | ### Como o paciente reserva 1. O agente identifica o serviço e consulta os horários reais disponíveis. 2. Se **Criar reservas** estiver ativo, ele pede os dados obrigatórios, resume o compromisso (serviço e horário) e espera uma confirmação explícita. Veja quais respostas contam como confirmação em [Confirmações do visitante](https://docs.chatnorris.ai/pt/guias/acciones.md#confirmações-do-visitante). 3. Só então ele cria a reserva e a informa ao paciente. Se o Encuadrado não confirmar a reserva, o agente não diz que ela foi agendada nem tenta de novo sozinho: ele pede ao paciente que verifique com a clínica ou pelo link público. > [!WARNING] > > No **Playground**, as reservas do Encuadrado são reais. Se o agente tiver esta Ação, antes da primeira mensagem você verá o aviso **Este teste pode criar dados reais** («Esta prueba puede crear datos reales»). Veja [Testar um agente](https://docs.chatnorris.ai/pt/guias/chatbots.md#testar-um-agente). ### Compromissos em Leads e no seu CRM Os compromissos agendados pelo agente com o Encuadrado aparecem em [Leads](https://docs.chatnorris.ai/pt/guias/leads.md), na coluna **Agendamento** e na seção **Agendamentos** do detalhe do lead. Se o agente também tiver a Ação [Pipedrive](https://docs.chatnorris.ai/pt/guias/pipedrive.md) com **Registrar reuniões agendadas**, cada compromisso confirmado é registrado no Lead do Pipedrive como atividade **Reunião**. Com uma ação de agenda pronta, pedir uma reunião ou uma ligação não é um handoff, mesmo que o visitante mencione um executivo ou consultor: o agente oferece horários. Veja [Human Handoff](https://docs.chatnorris.ai/pt/guias/acciones.md#human-handoff). ## Desconectar Em `Agentes → [seu agente] → Integrações → Encuadrado`, clique em **Desconectar**. A Ação Encuadrado é desabilitada e mantém a sua configuração, e a API key é apagada do ChatNorris. Para voltar a usá-la, conecte a conta novamente e reative a Ação. ## Perguntas frequentes > [accordion] Onde a conta do Encuadrado é conectada? > > Em **Integrações**, o hub centralizado de cada agente, e não na tela da Ação. Veja [Integrações](https://docs.chatnorris.ai/pt/guias/integraciones.md). > [accordion] O agente não oferece um serviço que existe no Encuadrado > > Verifique se o serviço foi adicionado em **Serviços**, com o seu **UUID do serviço** e **Habilitado** ligado. O agente só oferece os serviços configurados na Ação. > [accordion] Por que o agente não cria a reserva e só compartilha um link? > > O recurso **Criar reservas** está desligado: nesse caso, o agente só oferece horários e o link público do serviço. Ative-o em **O que pode fazer**. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.