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
- 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
- Nas configurações da assistente de IA, navegue até a seção Ferramentas
- Selecione Agendamento de Compromissos entre as ferramentas disponíveis
- Escolha Sua SofIA como seu tipo de integração de calendário
- Clique em Conectar à Sua SofIA
- Você será redirecionado para a página de autorização da Sua SofIA
- Escolha sua conta entre as opções disponíveis
- Autorize o aplicativo a acessar os dados do seu calendário
- 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:- Selecione o calendário específico da sua localização da Sua SofIA
- Seus calendários disponíveis serão automaticamente buscados e exibidos
- Escolha o calendário onde os compromissos devem ser agendados
4. Testando a Integração
Passos essenciais de teste:- Faça uma chamada de teste para sua assistente de IA
- Solicite agendar um compromisso durante a conversa
- Verifique se a reserva aparece no seu calendário da Sua SofIA
- Confira se os detalhes de confirmação são enviados adequadamente
- 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:- Defina o e-mail nas variáveis de entrada: Adicione
emailcomo uma variável de entrada nas configurações da assistente - Importe leads com e-mail: Ao importar leads, certifique-se de que os endereços de e-mail estão incluídos
- Coleta de IA durante a chamada: Configure sua assistente para solicitar o e-mail durante a conversa, se não estiver disponível
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
- 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
- Tente o modo anônimo para autorização OAuth
- Verifique as permissões da conta e a configuração do 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.

