Tipos de Erros e Avisos nos Perfis e Interação com APIs
A ligação entre o Swonkie e as redes sociais depende de autorizações (tokens) e da estabilidade das APIs de cada plataforma. Quando ocorrem falhas nessa comunicação, podem surgir erros ou avisos associados aos perfis conectados ou durante o uso de funcionalidades como agendamento, recolha de dados, entre outros.
Neste artigo explicamos os diferentes tipos de erros, avisos e os seus significados, bem como o que podes fazer para os resolver.
Tipos de Estados de Erro/Aviso
1. Aviso Preventivo
Quando acontece?
Cerca de 60 dias após a última atualização de acessos.
O que significa?
O Swonkie mostra um aviso a alertar que a ligação pode expirar em breve.
O que fazer?
Atualiza o acesso ao perfil diretamente na plataforma para garantir que a ligação continua ativa e evitar interrupções.
💡 Mesmo que o perfil ainda esteja a funcionar corretamente, este aviso serve para prevenir falhas iminentes.
2. Erro do Utilizador
Quando acontece?
O token falhou na sua última utilização.
O que significa?
O acesso foi revogado ou expirou, e o erro só pode ser resolvido com a ação do utilizador.
Exemplos comuns:
- Token expirado
- Permissões removidas na rede social
O que fazer?
É necessário aceder ao Swonkie e atualizar a ligação do perfil com as permissões corretas.
Problemas Técnicos Não Associados ao Perfil
Além dos erros ou avisos diretamente ligados aos tokens dos perfis, também podem ocorrer problemas técnicos durante a comunicação com as redes sociais.
3. Erro da Rede Social (API)
O que é?
A rede social pode estar com problemas temporários, em manutenção ou com limitações.
Como afeta?
Pode impedir a publicação de conteúdos ou recolha de dados num dado momento.
O que fazer?
Normalmente, não é necessária nenhuma ação do utilizador. A nossa equipa é notificada automaticamente e tentará novas sincronizações assim que possível.
4. Erro Interno da Aplicação (Swonkie)
O que é?
Algum problema técnico na execução de um pedido dentro do Swonkie (ex: tentativa de agendar uma publicação ou recolher métricas que falhou).
Como afeta?
O processo não foi concluído com sucesso.
O que fazer?
Se for possível, tenta novamente. Caso o erro persista, a nossa equipa já terá sido notificada e está a investigar o caso.
ℹ️ Estes erros não são mostrados como estado nos perfis, mas podem aparecer em logs ou mensagens associadas a uma publicação ou widget com falha.
Como identificar e resolver
- Verifica o ícone do perfil no menu de perfis conectados:
 | Aviso preventivo |
 | Erro de utilizador |
- Consulta os detalhes nas mensagens de erro nas publicações ou widgets.
- Atualiza os acessos sempre que possível para manter tudo a funcionar corretamente.