O que são WebHooks e conectores?What are webhooks and connectors?

WebHooks e conectores são uma maneira simples de conectar seus serviços Web a canais e equipes no Microsoft Teams.Webhooks and connectors are a simple way to connect your web services to channels and teams inside Microsoft Teams.

WebHooks de saídaOutgoing webhooks

Os WebHooks de saída permitem que os usuários enviem mensagens de texto de um canal para seus serviços Web.Outgoing webhooks allow your users to send text messages from a channel to your web services. Após a configuração, os usuários poderão @mention seu webhook de saída e enviar uma mensagem para o serviço.Once configured, your users will be able to @mention your outgoing webhook and send a message to your service. O serviço terá cinco segundos para enviar uma resposta para a mensagem, potencialmente contendo texto ou um cartão.Your service will have five seconds to send a response to the message, potentially containing text or a card.

Os WebHooks de saída são configurados em uma base por equipe, não podem ser incluídos como parte de um aplicativo de equipes normal.Outgoing webhooks are configured on a per-team basis, cannot be included as part of a normal Teams app. Eles são mais adequados para concluir as cargas de trabalho específicas da equipe que não exigem que grandes quantidades de informações sejam coletadas ou trocadas.They are best suited for completing team-specific workloads that don't require large amounts of information to be collected or exchanged.

Confira criar um webhook de saída.See Create an outgoing webhook.

ConectoresConnectors

Os conectores permitem que os usuários assinem receber notificações e mensagens de seus serviços Web.Connectors allow users to subscribe to receive notifications and messages from your web services. Eles expõem um ponto de extremidade HTTPS para o seu serviço postar mensagens para-normalmente na forma de cartões.They expose an HTTPS endpoint for your service to post messages to - typically in the form of cards.

WebHooks de entradaIncoming webhooks

Os WebHooks de entrada são um tipo de conector mais simples.Incoming webhooks are a the simplest type of connector. Para qualquer canal no Team (se eles estiverem habilitados para essa equipe), você pode optar por expor um ponto de extremidade HTTPS que aceitará corretamente o JSON e inserir mensagens nesse canal.For any channel in team (if they are enabled for that team) you can choose to expose an HTTPS endpoint that will accept correctly formatted JSON and insert messages into that channel. Eles são uma maneira rápida e fácil de conectar um canal ao seu serviço e são mais usados para cenários que são exclusivos para uma equipe específica.They are a quick and easy way to connect a channel to your service, and are best used for scenarios that are unique to a particular team. Por exemplo, você pode criar um webhook de entrada no seu canal do DevOps e configurar seus serviços de compilação, implantação e monitoramento para enviar alertas.For example, you could create an incoming webhook in your DevOps channel and configure your build, deployment and monitoring services to send alerts.

Confira criar um webhook de entrada.See Create an incoming webhook.

Conectores de Office 365Office 365 Connectors

Os conectores do Office 365 permitem criar uma página de configuração personalizada para o webhook de entrada e empacotá-los como parte de um aplicativo do teams.Office 365 Connectors allow you to create a custom configuration page for your incoming webhook, and package them as part of a Teams app. Em seguida, você pode distribuir esse aplicativo de forma mais ampla, ou até mesmo a nossa loja de aplicativos.You can then distribute that app more broadly, or even to our app store. Você envia mensagens principalmente usando cartões de conector do Office 365 e também tem a capacidade de adicionar um conjunto limitado de ações de cartão a eles.You send messages primarily using Office 365 Connector cards, and have the ability to add a limited set of card actions to them as well. Um bom exemplo disso é um conector meteorológico que permite que os usuários escolham um local e hora do dia para receber atualizações sobre o clima de amanhã.A good example of this is a weather connector that allows users to choose a location and time of day to receive updates about tomorrow's weather. Eles são configurados em um nível de canal, mas são instalados em nível de equipe.They are configured on a channel level, but are installed at a team level.

Confira criar um conector do Office 365.See Create an Office 365 Connector.