Enviar notificações do FyneDesk para o Microsoft Teams

Receba uma mensagem no seu canal do Teams sempre que um ticket for criado, comentado ou mudar de status. O FyneDesk envia o evento para um webhook, e um curto fluxo do Power Automate o transforma em uma mensagem do Teams. Siga os passos abaixo na ordem — leva cerca de dez minutos.

Como funciona

O FyneDesk envia cada evento (novo ticket, novo comentário e assim por diante) como um pequeno pacote de dados JSON para a URL que você fornecer. O Microsoft Teams não exibe esse pacote sozinho — o seu fluxo do Power Automate precisa pegar os dados e publicá-los como uma mensagem.

É por isso que um teste pode dizer "enviado com sucesso" enquanto nada aparece no Teams: o Power Automate responde 202 Accepted no instante em que recebe uma solicitação, então "sucesso" significa apenas que a Microsoft recebeu os dados. Não diz nada sobre se uma mensagem foi publicada. Assim que você adicionar a etapa de publicação na Parte 3, as mensagens aparecerão.

Antes de começar

• Um team e um canal do Microsoft Teams onde você quer as notificações, e uma conta do Power Automate com uma licença que possa publicar no Teams.
• Acesso de administrador aos webhooks do FyneDesk, em Admin Settings → Advanced → Webhooks (também acessível por Settings → Connections → Webhooks).
• Cerca de dez minutos. Você vai criar um fluxo a partir de um template pronto, colar a URL dele no FyneDesk e depois adicionar uma etapa que publica a mensagem.

Configurar

Este é exatamente o caminho que a nossa equipe usa, de ponta a ponta. Ele produz uma mensagem de texto simples e legível. (Quer que a mensagem nomeie cada tipo de evento, ou prefere um cartão formatado? Veja as opções avançadas abaixo.)

Parte 1 — Crie o fluxo a partir de um template

Acesse make.powerautomate.com e faça login. No menu à esquerda, escolha Templates, digite webhook na caixa de pesquisa e abra Send webhook alerts to a channel — o simples, não as versões "(TEST)". Clique em Continue (faça login novamente se for solicitado).

O template mostra que vai conectar Teams → Microsoft Teams e gerar uma URL de webhook. Antes de clicar em Create, defina o Team e o Channel em que você quer que as notificações sejam publicadas — é fácil deixar passar, e faz diferença.

Escolha o seu Team e o canal, depois clique em Create. Quando o fluxo abrir, clique em Edit para começar a editá-lo.

Parte 2 — Forneça a URL ao FyneDesk

No fluxo, clique na primeira caixa, "When a Teams webhook request is received," e copie a HTTP URL que ela mostra.

Depois, no FyneDesk, vá em Admin Settings → Advanced → Webhooks e clique em Add webhook:

• Dê um nome que você reconheça depois, por exemplo, Microsoft Teams.
• Cole a URL do Power Automate em Endpoint URL (deve ser um link HTTPS).
• Deixe ticket.created marcado — é tudo o que você precisa para começar. (Você pode adicionar mais eventos depois.)
• Clique em Save.

Parte 3 — Diga ao fluxo o que publicar

Esta é a etapa fácil de deixar passar — e é exatamente por isso que um teste pode dizer "enviado" enquanto nada aparece no Teams.

1. Exclua as duas etapas pré-criadas. O template adiciona uma ação Initialize variable (às vezes duas) e uma condição Attachments is null. Exclua as duas — clique nos … de cada etapa e depois em Delete. Deixá-las é o que dispara o erro "AdaptiveCard".

2. Adicione a ação de publicação. Clique no + abaixo do gatilho e escolha Post message in a chat or channel (o conector do Microsoft Teams). Defina as listas suspensas:

3. Monte a mensagem. Clique dentro da caixa Message, clique no botão azul fx (Insert expression), cole a expressão abaixo exatamente e depois clique em Add.

concat('New ticket ', triggerBody()?['data']?['ticket_number'], ' - ', triggerBody()?['data']?['title'], ' | Status: ', triggerBody()?['data']?['status'], ' | Priority: ', triggerBody()?['data']?['priority'], ' | https://fynedesk.ai/tickets/', string(triggerBody()?['data']?['id']))

4. Salve. Clique em Save (canto superior direito). Você deve ver "Your flow is ready to go."

Parte 4 — Teste

Crie ou atualize um ticket real no FyneDesk. Uma mensagem aparece no seu canal do Teams em poucos segundos.

Opcional: rotule cada evento ou publique um cartão

A expressão acima sempre começa com "New ticket". Se você quiser que a mensagem nomeie o evento (novo comentário, mudança de status e assim por diante) ou preferir um cartão formatado, use uma das opções abaixo. A configuração é idêntica — só a expressão de Message muda.

O que o FyneDesk envia

O seu webhook pode assinar quatro eventos. Veja o formato de cada pacote (os valores são exemplos).

ticket.created

{
  "event": "ticket.created",
  "timestamp": "2026-05-30T22:19:59",
  "organization": { "id": 173, "name": "SafePACS" },
  "data": {
    "id": 6381,
    "ticket_number": "INC004736",
    "title": "Printer not working",
    "description": "The 3rd floor printer is offline",
    "status": "New",
    "priority": "Medium",
    "ticket_type": "Incident",
    "source": "Email",
    "created_at": "2026-05-30T22:19:59"
  }
}

ticket.updated e ticket.status_changed usam o mesmo formato acima, mais updated_at, assigned_to e assigned_team_id.

ticket.commented — observe que os nomes dos campos são um pouco diferentes aqui:

{
  "event": "ticket.commented",
  "timestamp": "2026-05-30T22:19:59",
  "organization": { "id": 173, "name": "SafePACS" },
  "data": {
    "ticket_id": 6381,
    "ticket_number": "INC004736",
    "ticket_title": "Printer not working",
    "ticket_status": "New",
    "content": "Any update on this?",
    "comment_id": 8809,
    "is_internal": false
  }
}

Opção A — Uma mensagem de texto mais rica

Em vez da expressão única, digite o layout abaixo na caixa Message. Tudo o que não for um 〈placeholder〉 é texto simples que você digita. Para cada 〈placeholder〉, clique no botão fx, cole a expressão correspondente da tabela e depois clique em Add.

〈eventLabel〉  〈ticketNumber〉
〈title〉

Status: 〈status〉   •   Priority: 〈priority〉

〈message〉

Open in FyneDesk: 〈link〉

Opção B — Um cartão formatado

Prefere um cartão? Use a ação Post card in a chat or channel e cole o seguinte no campo Adaptive Card. Ela usa as mesmas expressões, então são os mesmos dados em um layout mais organizado.

{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.2",
  "body": [
    {
      "type": "TextBlock",
      "size": "Medium",
      "weight": "Bolder",
      "text": "@{if(equals(triggerBody()?['event'],'ticket.created'),'🎫 New ticket',if(equals(triggerBody()?['event'],'ticket.commented'),'💬 New comment',if(equals(triggerBody()?['event'],'ticket.status_changed'),'🔄 Status changed','✏️ Ticket updated')))} @{triggerBody()?['data']?['ticket_number']}"
    },
    {
      "type": "TextBlock",
      "text": "@{coalesce(triggerBody()?['data']?['title'],triggerBody()?['data']?['ticket_title'],'(no title)')}",
      "wrap": true
    },
    {
      "type": "FactSet",
      "facts": [
        { "title": "Status", "value": "@{coalesce(triggerBody()?['data']?['status'],triggerBody()?['data']?['ticket_status'],'-')}" },
        { "title": "Priority", "value": "@{coalesce(triggerBody()?['data']?['priority'],'-')}" }
      ]
    },
    {
      "type": "TextBlock",
      "text": "@{coalesce(triggerBody()?['data']?['content'],triggerBody()?['data']?['description'],'')}",
      "wrap": true
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "Open in FyneDesk",
      "url": "@{concat('https://fynedesk.ai/',if(equals(triggerBody()?['data']?['ticket_type'],'Service Request'),'requests/','tickets/'),string(coalesce(triggerBody()?['data']?['id'],triggerBody()?['data']?['ticket_id'])))}"
    }
  ]
}

Solução de problemas

Uma observação sobre segurança

A sua URL do Power Automate contém uma assinatura secreta (a parte sig=...) — trate a URL inteira como uma senha e não a compartilhe. O FyneDesk também assina cada solicitação com um cabeçalho X-FyneDesk-Signature (HMAC-SHA256), caso você queira verificar a autenticidade dentro do fluxo, embora isso seja opcional e não seja necessário para receber as mensagens.

Perguntas frequentes