Solução de problemas de Integração

Se uma integração não conectar, parar de funcionar ou não conseguir concluir uma tarefa, use este guia para verificar a conexão, o acesso à conta e o recurso selecionado.

Esta página aborda problemas comuns de conexão e autorização no Atoms. Para configuração específica de serviço, ações compatíveis ou configuração dentro do seu app, comece com Conectar e Gerenciar Integrações e escolha o guia do seu serviço.

Comece com estas verificações

1. Verifique onde a falha acontece. O Agente não consegue usar um serviço no Chat ou o recurso falha apenas no seu app? Conectar um serviço para o Chat não confirma, por si só, que seu app está configurado corretamente. Para falhas apenas no app, consulte Conectar e Gerenciar Integrações.
2. Abra a integração. No Chat do seu projeto, abra o menu de opções ao lado da entrada de mensagem e escolha Connectors → Add connectors. Pesquise e selecione o serviço. Verifique se ele está conectado ou se ainda oferece Connect. Alguns serviços abrem sua própria tela de gerenciamento.
3. Verifique o acesso no próprio serviço. Confirme que a conta que você pretendia conectar pode abrir o arquivo, repositório, calendário, propriedade ou outro recurso exato envolvido.
4. Salve o erro antes de alterar qualquer coisa. Registre a mensagem exata, a data, a hora e o fuso horário, o projeto ou Chat afetado e a última tentativa bem-sucedida. Oculte informações privadas das capturas de tela.

Abra as opções de entrada do Chat, escolha Connectors (1) e depois Add connectors (2) para navegar pelas integrações disponíveis.

Você também pode gerenciar as conexões disponíveis em Settings → Connectors. Selecione a integração que deseja verificar.

Mantenha as credenciais privadas. Nunca cole senhas, códigos de login, chaves de API, tokens de acesso ou outros segredos no Chat ou em uma solicitação de suporte. Insira credenciais apenas no fluxo de login do serviço ou no campo de configuração seguro designado.

Encontre seu problema

Você não consegue encontrar ou iniciar uma integração

1. Use Add connectors para pesquisar no catálogo. A lista mais curta no menu do Chat não é o catálogo completo.
2. Se o Atoms disser que o recurso está disponível apenas dentro de um projeto, abra o projeto pretendido e tente lá.
3. Se um controle estiver desativado, leia a explicação. Se ele exigir uma função ou permissão diferente, peça ajuda ao proprietário do projeto ou do espaço de trabalho. Não desconecte outro serviço apenas para contornar uma restrição.

Verifique o resultado: Você consegue abrir a tela de conexão ou gerenciamento do serviço. Se ele ainda não aparecer, consulte Conectar e Gerenciar Integrações ou entre em contato com o suporte para confirmar a disponibilidade. Não presuma que um serviço ausente possa ser habilitado por meio de repetidas tentativas de login.

A autorização não é concluída

1. Selecione Connect uma vez e procure a janela de login do serviço. Se o seu navegador informar um pop-up bloqueado, permita pop-ups para o site do Atoms e tente novamente. No Chrome, siga as instruções para permitir pop-ups de um site específico; você não precisa habilitá-los para todos os sites.
2. Escolha a conta pretendida e revise o acesso solicitado. Conclua o fluxo de autorização do serviço antes de fechar a janela.
3. Se o serviço disser explicitamente que sua organização bloqueou o app ou o acesso solicitado, salve a mensagem e entre em contato com seu administrador. Não contorne a política da sua organização.
4. Volte ao Atoms e reabra a integração para verificar o estado dela. Fechar uma janela de login não confirma que a autorização foi bem-sucedida.

Revise o acesso solicitado antes de concluir a autorização. Autorizar uma conta não confirma, por si só, que o recurso pretendido está conectado.

Se a autorização incluir um seletor de organização ou espaço de trabalho, confirme a seleção pretendida e revise as permissões solicitadas.

Verifique o resultado: A integração é exibida como conectada. Nas telas de detalhes do connector que usam o layout padrão, Connect é substituído por Disconnect e Try it out. Outros serviços têm seus próprios layouts. Se ainda oferecer Connect ou mostrar um erro, capture esse resultado e entre em contato com o suporte após uma nova tentativa.

A conta errada está conectada

Se a tela de gerenciamento da integração mostrar uma conta, compare-a com a conta que possui ou pode acessar o recurso. Nem todo connector exibe a conta conectada, então não use apenas o login atual do navegador como prova de qual conta o Atoms está usando.

Abra o recurso diretamente no serviço com a conta pretendida. Se essa conta não puder acessá-lo, peça acesso primeiro ao proprietário do recurso. Se a conexão usar a conta errada, siga as instruções do serviço para trocar de conta ou reconecte com segurança e escolha explicitamente a conta correta durante a autorização.

Verifique o resultado: Uma pequena solicitação de leitura compatível retorna o recurso pretendido. Se você ainda não conseguir determinar qual conta está conectada, entre em contato com o suporte em vez de desconectar repetidamente.

A integração está conectada, mas o Agente não consegue encontrar seus dados

1. Verifique a conexão. Abra os detalhes da integração em Connectors e confirme que ela está conectada. Verifique a conta ou o recurso selecionado, quando exibido.
2. Verifique o recurso exato. Abra-o diretamente no serviço com a conta pretendida. Confirme sua localização e permissões de acesso, incluindo a organização, espaço de trabalho, pasta ou propriedade corretos, quando relevante.
3. Torne a solicitação específica. Nomeie o serviço e forneça o nome exato do recurso ou o link quando o connector oferecer suporte a isso. Peça primeiro uma ação de leitura compatível, em vez de pesquisar e alterar vários recursos ao mesmo tempo.

Por exemplo, se o connector oferecer suporte à leitura de documentos: “Use [service] para ler [nome ou link do documento] e me dizer seu título. Não o altere.”

Verifique o resultado: O Agente retorna o recurso pretendido. Se o acesso direto funcionar, mas o Agente ainda não conseguir lê-lo, verifique as capacidades compatíveis do connector e o acesso concedido. Reconecte apenas se houver evidência de um problema de autorização.

O Agente consegue ler dados, mas não consegue alterá-los

Uma leitura bem-sucedida não confirma que o connector oferece suporte à alteração solicitada ou tem permissão para realizá-la.

1. Consulte Conectar e Gerenciar Integrações ou a lista What you can do do connector, se exibida. Confirme que a ação solicitada é compatível.
2. Verifique se a conta conectada tem permissão para fazer essa alteração no recurso exato. Peça ao proprietário do recurso ou ao administrador apenas o acesso necessário.
3. Leia qualquer erro ou solicitação de confirmação. Se for necessária autorização adicional, siga o fluxo documentado do serviço. Reconectar não pode adicionar uma ação que o connector não oferece suporte.

Antes de tentar novamente uma gravação: Inspecione o destino para ver se a primeira tentativa já criou ou alterou algo. Uma resposta de falha não é suficiente para provar que nenhuma alteração ocorreu. Não repita um pagamento, mensagem, convite ou criação de registro até saber o resultado anterior.

Verifique o resultado: Uma alteração compatível é concluída com sucesso em um recurso de teste apropriado, e você a confirma diretamente no serviço. Para pagamentos ou outros fluxos de trabalho em produção, use as instruções de teste específicas do serviço em vez de uma transação real.

Uma conexão que funcionava antes parou

Verifique o que mudou desde a última solicitação bem-sucedida: a conta, o acesso dela ao recurso, a política de apps da organização ou a autorização da conexão.

1. Reabra a integração no Atoms e verifique se ela ainda está conectada.
2. Tente abrir o recurso diretamente no serviço. Se o acesso tiver sido removido, resolva isso com o proprietário do recurso ou com o administrador.
3. Se o erro disser que a autorização expirou, foi revogada ou é inválida, siga Reconectar com segurança. Se o erro estiver relacionado a uma indisponibilidade do serviço, limite ou ação não compatível, trate essa causa primeiro.

Verifique o resultado: Uma pequena solicitação de leitura volta a funcionar. Se o mesmo erro persistir, salve-o junto com o horário da última execução bem-sucedida e entre em contato com o suporte.

Os resultados estão desatualizados ou uma solicitação continua falhando

1. Compare o resultado com o próprio serviço. Confirme a conta, o recurso, o intervalo de datas, os filtros e o fuso horário, quando relevante. Peça ao Agente para buscar o valor atual em vez de confiar em uma resposta anterior na conversa.
2. Para um erro explícito de timeout ou serviço indisponível, verifique a página oficial de status ou ajuda do serviço. Se o erro informar um horário para tentar novamente, espere até lá; não envie solicitações repetidas enquanto o limite ou a indisponibilidade persistir.
3. Salve qualquer texto não enviado, atualize o Atoms e verifique novamente o estado do connector. Atualizar a página não é o mesmo que reautorizar a conta.
4. Tente novamente uma pequena solicitação de leitura. Antes de repetir qualquer coisa que altere dados externos, inspecione o destino para verificar o resultado anterior.

Verifique o resultado: O resultado atualizado corresponde ao recurso pretendido no serviço. Se continuar incorreto, envie ao suporte os valores esperados e reais com registros de data e hora. Não presuma que toda integração é atualizada no mesmo ritmo.

Reconectar com segurança

Reconecte quando a autorização for inválida ou a conta errada estiver vinculada — não como primeira etapa para toda solicitação com falha.

Antes de desconectar: Conclua ou pause tarefas que dependem da conexão, verifique o resultado de qualquer gravação externa pendente e certifique-se de que você pode entrar novamente com o acesso necessário. Desconectar torna a conexão indisponível até que ela seja conectada novamente. Consulte Conectar e Gerenciar Integrações para quaisquer efeitos adicionais; não presuma que desconectar reverte alterações anteriores ou cancela trabalhos já enviados.

1. Abra os detalhes da conexão do serviço. Se ele tiver sua própria tela de gerenciamento de conta, siga as instruções dessa integração.
2. Na tela padrão de detalhes do connector, selecione Disconnect quando estiver pronto e depois selecione Connect. Não presuma que haverá uma confirmação extra antes da desconexão.
3. Escolha a conta pretendida e conclua a autorização. Revise as permissões solicitadas.
4. Volte ao Atoms e confirme o estado conectado.
5. Execute a verificação de recuperação abaixo antes de retomar a tarefa original.

Se o mesmo erro voltar, pare de reconectar e entre em contato com o suporte com o erro e as verificações já concluídas.

Verifique se o problema foi resolvido

1. Peça uma ação compatível e somente leitura em um recurso que você possa verificar diretamente. Se usar Try it out, revise o prompt sugerido antes de enviá-lo.
2. Compare a resposta com o próprio serviço. Confirme o recurso correto, o contexto da conta e o resultado solicitado — não apenas o indicador de conectado.
3. Se sua tarefa exigir alterações, use um recurso de teste apropriado ou o fluxo de teste documentado do serviço e verifique o resultado no destino.

Verifique o estado da conexão e o recurso selecionado. Um indicador de conectado, por si só, não confirma que os dados esperados estão disponíveis ou atualizados.

Confirme a organização e o projeto e depois abra Dashboard para inspecionar o recurso sem fazer alterações. Desconectar não faz parte desta verificação.

Se a verificação passar, retome sua tarefa. Se o Chat funcionar, mas o recurso ainda falhar dentro do seu app, consulte Conectar e Gerenciar Integrações ou solução de problemas de build e preview. Verifique o ambiente em que a falha ocorre; uma solicitação bem-sucedida no Chat não prova que o app está configurado corretamente.

Obter ajuda

Se o problema persistir, use Obter suporte e inclua:

• O nome da integração e o e-mail da sua conta Atoms.
• O projeto afetado ou o link do Chat, e se a falha acontece no Chat ou no seu app. Para um app, identifique o ambiente afetado.
• A conta de serviço e o recurso pretendidos, usando apenas identificadores não secretos necessários para investigar.
• O erro exato, a data, a hora e o fuso horário; inclua o horário da última execução bem-sucedida, se souber.
• As etapas para reproduzir, o resultado esperado, o resultado real e as verificações já tentadas.
• Seu navegador e dispositivo, além de capturas de tela com informações ocultadas ou uma gravação curta, se útil.

Para uma gravação com falha, informe se o destino mostra uma alteração concluída, nenhuma alteração ou um resultado desconhecido. Remova senhas, códigos de login, chaves de API, tokens e dados privados não relacionados de todos os anexos.