Como podemos ajudar?

Ao relatar um problema de integração, fornecer informações claras e relevantes ajuda a equipe de suporte a entender o serviço afetado, reproduzir o problema quando possível e identificar a causa provável. Um pedido de suporte útil deve descrever o que você tentou, o que esperava e o que realmente aconteceu. Informações a incluir 1. Nome da integração Identifique o aplicativo ou serviço externo envolvido. 2. Descrição do problema Explique a operação que falhou ou produziu um resultado inesperado. 3. Comportamento esperado Descreva o que deveria ter acontecido. 4. Comportamento real Descreva o que aconteceu em vez disso. 5. Mensagem de erro Inclua o texto exato do erro ou o código de status, se disponível. 6. Timestamp aproximado Forneça a data, hora e fuso horário em que o problema ocorreu. 7. Operação afetada Identifique a ação de integração relevante, fluxo de trabalho, automação ou processo de negócios. 8. Frequência Explique se o problema ocorre de forma consistente ou intermitente. 9. Mudanças recentes Mencione mudanças recentes na conta, permissões, configuração ou autorização. 10. Solução de problemas já tentada Descreva os passos tomados antes de entrar em contato com o suporte. 11. Impacto nos negócios Explique se o problema impede uma operação crítica, afeta clientes ou causa atrasos. 12. Evidências de apoio Inclua capturas de tela relevantes ou detalhes de diagnóstico não sensíveis, quando disponíveis. Exemplo de solicitação de suporte Assunto: Problema de conexão de integração Integração: [Nome do serviço externo] Operação afetada: [Descrição da operação] O problema começou: [Data e hora com fuso horário] Resultado esperado: [O que deveria acontecer] Resultado real: [O que aconteceu] Mensagem de erro: [Mensagem de erro exata] Mudanças recentes: [Mudanças relevantes, se houver] Solução de problemas concluída: [Passos já tentados] Impacto nos negócios: [Descrição das operações afetadas] Quais informações nunca devem ser compartilhadas? Não inclua: 1. Senhas. 2. Chaves de API. 3. Tokens de acesso OAuth. 4. Tokens de atualização OAuth. 5. Segredos do cliente. 6. Segredos de assinatura de Webhook. 7. Credenciais de autenticação privadas. 8. Informações pessoais desnecessárias dos clientes. 9. Registros comerciais sensíveis não relacionados ao problema. Se uma captura de tela contiver informações confidenciais, redija-a antes de compartilhar. Devo desconectar a integração antes de entrar em contato com o suporte? Não automaticamente. Desconectar ou reautorizar uma integração pode mudar seu estado e dificultar a investigação do problema original. Se a integração for suspeita de atividade não autorizada, priorize a contenção de segurança apropriada. E se o problema afetar uma operação comercial importante? Descreva claramente o impacto nos negócios e se a operação está completamente bloqueada ou apenas parcialmente afetada. E se o provedor externo estiver enfrentando uma interrupção? Inclua qualquer informação relevante sobre o status do provedor e o tempo aproximado em que o problema começou. O suporte pode garantir a recuperação de operações externas falhadas? A recuperação depende da operação, do comportamento do provedor externo e dos mecanismos de repetição ou recuperação disponíveis. Não presuma que cada operação falhada pode ser reproduzida automaticamente. Abordagem recomendada Envie um relatório conciso, mas completo, com o erro exato, a integração afetada, os timestamps relevantes e o impacto nos negócios. Isso ajuda a reduzir idas e vindas desnecessárias e apoia uma investigação mais eficaz.