Conectar o Microsoft Teams Chat (clientes externos)

Esse canal é diferente de qualquer integração de reuniões do Teams que você já use: aqui você conecta o chat 1 a 1 (ou em grupo) com clientes externos via Microsoft Graph, para que essas conversas apareçam no Inbox da Omnifox junto com os demais canais.

Requisitos

• Um tenant do Azure AD / Microsoft 365 com permissões de administrador
• Permissão "Gerenciar canais" na Omnifox

Passos para conectar

1. Na Omnifox, vá em Canais → Conectar novo canal e escolha Microsoft Teams Chat.
2. Clique em Conectar com Microsoft — você será redirecionado ao login do Azure AD (endpoint v2.0).
3. Faça login com uma conta com permissões de administrador no seu tenant e aceite as permissões solicitadas (Chat.ReadWrite, ChatMessage.Send, User.Read, acesso offline).
4. A Microsoft te devolve à Omnifox; o canal é ativado automaticamente.

Configuração

A conexão é 100% OAuth — não há tokens para colar manualmente. A Omnifox renova o token de acesso automaticamente (dura cerca de 1 hora) usando o refresh token (válido por semanas), e também renova a assinatura de eventos do Graph antes que ela expire.

Exemplo

Um cliente externo com uma conta Microsoft escreve num chat 1 a 1 do Teams perguntando sobre o status de um chamado. Essa mensagem chega ao Inbox da Omnifox como uma conversa do Teams, sem o atendente precisar abrir o app do Teams.

Dicas

• Esse canal lida com mensagens de chat (ChatMessage), não com reuniões ou chamadas do Teams — são produtos diferentes dentro do Microsoft Graph.
• Se sua organização usa um tenant restrito ("single tenant"), confirme com seu administrador de TI que o app da Omnifox está aprovado antes de conectar.

Solução de problemas

• A autorização falha com erro de permissão: peça ao seu admin do Microsoft 365 para aprovar o consentimento da aplicação em nível de tenant.
• As mensagens param de chegar depois de um tempo: pode ser que a assinatura do Graph tenha expirado sem renovar; reconecte o canal para forçar uma nova assinatura.