Criar Webhooks de entrada
Um Webhook de Entrada permite que aplicativos externos compartilhem conteúdos nos canais do Microsoft Teams. Os webhooks são usados como ferramentas para rastrear e notificar. Os webhooks fornecem uma URL exclusiva para enviar uma carga JSON com uma mensagem no formato de cartão. Os cartões são contêineres de interface do usuário que incluem conteúdo e ações relacionadas a um único tópico. Você pode usar os cartões nos seguintes recursos:
- Bots
- Extensões de mensagens
- Conectores
Veja o vídeo a seguir para saber como criar um Webhooks de entrada:
Principais recursos de um Webhook de Entrada
A tabela a seguir fornece os recursos e a descrição de um Webhook de Entrada:
| Recursos | Descrição |
|---|---|
| Envie cartões adaptáveis usando um Webhook de Entrada | Cartões Adaptáveis pode ser enviado por meio de Webhooks de Entrada. Para obter mais informações, consulte Enviar Cartões Adaptáveis usando Webhooks de Entrada. |
| Suporte a mensagens acionáveis | Os cartões de mensagem a ação são suportados em todos os grupos do Office 365, incluindo o Teams. Se você enviar mensagens por meio de cartões, deverá usar o formato de cartão de mensagem acionável. Para mais informações, consulte o legado de referência de cartões de mensagens acionáveis e playground de cartões de mensagens. |
| Suporte independente a mensagens HTTPS | Os cartões fornecem informações de forma clara e consistente. Qualquer ferramenta ou estrutura que possa enviar solicitações HTTPS POST pode enviar mensagens para o Teams por meio de um Webhook de Entrada. |
| Markdown compatível | Todos os campos de texto em cartões de mensagens acionáveis suportam Markdown básico. Não use a marcação HTML em seus cartões. O HTML será ignorado e tratado como texto sem formatação. |
| Configuração com escopo | O Webhook de Entrada tem escopo e está configurado no nível do canal. |
| Definições de recursos seguros | As mensagens são formatadas como cargas JSON. Essa estrutura declarativa de mensagens impede a inserção de código mal-intencionado. |
Observação
- Bots do Teams, extensões de mensagens, Webhook de entrada e Bot Framework suporte a Cartões Adaptáveis. Os Cartões Adaptáveis são uma estrutura de plataforma de cartão cruzado aberta que é usada em todas as plataformas, como Windows, Android, iOS e assim por diante. Atualmente, os Conectores Teams não suportam os Cartões Adaptáveis. No entando, é impossível criar um fluxo que publicam Cartões Adaptáveis para um canal Teams.
- Para mais informações sobre cartões e webhooks, veja Cartões Adaptáveis e Webhooks de Entrada.
Criar um webhook de entrada
Para adicionar um Webhook de Entrada a um canal do Teams, siga as seguintes etapas:
Abra o canal ao qual você deseja adicionar o gancho da web e selecione ••• Mais opções a partir da barra de navegação superior.
Selecione Conectadores no menu suspenso:
Pesquise para Webhook de Entrada e selecione Adicionar.
Selecionar Configurar, providenciar um nome, e atualize uma imagem para seu webhook se necessário:
Copie e salve a URL exclusiva do webhook presente na janela de diálogo. A URL mapeia o canal e você pode usá-la para enviar informações ao Teams. Selecione Concluído.
O webhook está disponível no canal do Teams.
Você pode criar e enviar mensagens acionáveis por meio do Webhook de Entrada ou do Conector do Office 365. Para obter mais informações, veja Criar e enviar mensagens.
Observação
No Teams, selecione Definições > Permitir aos membros > criar, atualizar, e remover conectores, para que qualquer membro da equipe possa adicionar, modificar ou excluir um conector.
Remover um Webhook de Entrada
Para remover um Webhook de Entrada de um canal do Teams, siga as seguintes etapas:
Abra o canal e selecione ••• Mais opções na barra de navegação superior.
Selecione Conectores de um menu suspenso.
Selecione Configurado em Gerenciar.
Selecione o <1> Configurado para ver uma lista de seus conectores atuais:
Selecione Gerenciar para o conector que você deseja eliminar:
Selecione Remover para exibir a caixa de diálogo Remover Configuração.
Preencha os campos da caixa de diálogo e as caixas de seleção e selecione Remover.
Exemplo de código
| Nome de exemplo | Descrição | C# | Node.js |
|---|---|---|---|
| Webhook de entrada | Este código de exemplo demonstra como enviar o cartão usando um webhook de entrada. | View | Exibir |