Skip to main content
Habilite sua assistente de IA para agendar reuniões e compromissos de forma integrada com a Sua SofIA. Este recurso poderoso permite que sua IA verifique a disponibilidade e agende reuniões diretamente durante as chamadas com seu sistema de calendário da Sua SofIA.

Pré-requisitos

Antes de configurar a integração com a Sua SofIA, você precisará de:
  • Uma conta ativa da Sua SofIA
  • Calendário(s) configurados na sua localização da Sua SofIA
  • Permissões de administrador ou apropriadas para autorizar conexões de aplicativos

Processo de Configuração

1. Requisitos da Conta da Sua SofIA

Configuração da Conta:
  • Certifique-se de que você possui uma conta ativa da Sua SofIA
  • Verifique se seus calendários estão configurados corretamente na sua conta
  • Confirme que você possui as permissões necessárias para conectar aplicativos externos
Configuração do Calendário:
  • Crie ou verifique calendários existentes na sua localização da Sua SofIA
  • Defina horários de disponibilidade e configurações de agendamento apropriadas
  • Configure quaisquer campos personalizados necessários para compromissos

2. Conectando a Sua SofIA à Sua Assistente

  1. Nas configurações da assistente de IA, navegue até a seção Ferramentas
  2. Selecione Agendamento de Compromissos entre as ferramentas disponíveis
  3. Escolha Sua SofIA como seu tipo de integração de calendário
  4. Clique em Conectar à Sua SofIA
Processo de Autorização OAuth:
  1. Você será redirecionado para a página de autorização da Sua SofIA
  2. Escolha sua conta entre as opções disponíveis
  3. Autorize o aplicativo a acessar os dados do seu calendário
  4. Você será redirecionado de volta para as configurações da sua assistente
Se você tiver problemas para se conectar à Sua SofIA, tente usar uma janela de navegação anônima/privada, pois isso pode resolver conflitos de autenticação.

3. Seleção de Calendário

Após a conexão bem-sucedida:
  1. Selecione o calendário específico da sua localização da Sua SofIA
  2. Seus calendários disponíveis serão automaticamente buscados e exibidos
  3. Escolha o calendário onde os compromissos devem ser agendados

4. Testando a Integração

Passos essenciais de teste:
  1. Faça uma chamada de teste para sua assistente de IA
  2. Solicite agendar um compromisso durante a conversa
  3. Verifique se a reserva aparece no seu calendário da Sua SofIA
  4. Confira se os detalhes de confirmação são enviados adequadamente
  5. Teste diferentes cenários (horários disponíveis/não disponíveis)

Informações Necessárias da Sua SofIA

Para completar a integração, o sistema precisa de acesso a:

Da Sua Conta da Sua SofIA:

  • ID da Localização: Obtido automaticamente durante a autorização OAuth
  • IDs dos Calendários: Recuperados dos calendários disponíveis na sua localização
  • Tokens de Acesso: Gerenciados automaticamente através do fluxo OAuth

Permissões do Calendário:

  • Ler disponibilidade do calendário: Para verificar horários disponíveis
  • Criar compromissos: Para agendar novas reuniões
  • Acessar detalhes do calendário: Para recuperar nomes e configurações dos calendários

Recursos da Integração

Agendamento Automático de Compromissos

  • Verificação de disponibilidade em tempo real: A IA verifica horários disponíveis
  • Confirmação instantânea de agendamento: Compromissos criados imediatamente na Sua SofIA
  • Prevenção de conflitos: O sistema evita agendamentos duplos
  • Tratamento de fusos horários: Respeita os fusos horários do calendário e do cliente

Requisito de E-mail para Compromissos

Importante: Para agendar compromissos, sua assistente de IA precisa de um endereço de e-mail do cliente. Opções de configuração:
  1. Defina o e-mail nas variáveis de entrada: Adicione email como uma variável de entrada nas configurações da assistente
  2. Importe leads com e-mail: Ao importar leads, certifique-se de que os endereços de e-mail estão incluídos
  3. Coleta de IA durante a chamada: Configure sua assistente para solicitar o e-mail durante a conversa, se não estiver disponível
Exemplo de instrução de prompt:

Melhores Práticas

Gestão de Calendário

  • Mantenha os calendários atualizados: Certifique-se de que a disponibilidade está atual na Sua SofIA
  • Defina tempos de intervalo: Configure lacunas apropriadas entre os compromissos
  • Use nomes de calendário claros: Facilita a seleção durante a configuração

Configuração da Assistente

  • Inclua o contexto do calendário no prompt do sistema: Ajuda a IA a entender cenários de agendamento
  • Defina variáveis de compromisso: Extraia informações relevantes para a Sua SofIA
  • Configure a duração do compromisso: Especifique quanto tempo os compromissos devem durar
Configuração da Duração do Compromisso: Informe sua assistente de IA sobre a duração dos compromissos no prompt do sistema:
Exemplos de cenários:
  • Cliente diz: “Podemos nos encontrar às 2:00 PM?”
  • IA agenda: 2:00 PM - 2:45 PM (intervalo de 45 minutos)
  • Teste vários cenários: Diferentes solicitações de horário, conflitos, reagendamentos

Segurança e Conformidade

  • Gerenciamento de tokens: Tokens OAuth são atualizados automaticamente
  • Privacidade de dados: Apenas os dados necessários do calendário são acessados
  • Escopo de permissão: A integração utiliza permissões mínimas necessárias

Solução de Problemas

Soluções Rápidas:

Erro de Chave de API Ausente:
  • Solução: Desconecte e reconecte sua conta da Sua SofIA, depois selecione uma assistente e salve
  • Passos: Vá para configurações da assistente → Agendamento de Compromissos → Desconectar → Conectar novamente → Selecionar assistente → Salvar
Problemas de Conexão:
  • Tente o modo anônimo para autorização OAuth
  • Verifique as permissões da conta e a configuração do calendário
Problemas de Calendário:
  • Atualize a conexão se os calendários não aparecerem
  • Verifique os fusos horários e as configurações de disponibilidade
Para solução de problemas abrangente da Sua SofIA, incluindo soluções detalhadas e problemas adicionais, consulte Problemas da Sua SofIA.