DEV Community

Angelo Matias
Angelo Matias

Posted on

Copilot Studio com APIs externas: plug and play com seu backend

O Copilot Studio não é só botzinho com FAQ. Dá pra conectar com qualquer API REST, enviar dados, buscar status de pedidos, consultar sistemas legados… e tudo isso de forma declarativa. Bora ver como!

Quando usar uma API externa?

Você quer que seu Copilot:

  • Consulte um sistema interno (ex: CRM, ERP, banco de dados)
  • Envie informações (ex: abrir chamados, cadastrar leads, agendar compromissos)
  • Busque dados em tempo real (ex: status de pedido, rastreamento, previsão do tempo)
  • Sim, dá pra fazer tudo isso com uma API REST + Power Automate + Copilot Studio.

Como funciona a mágica?

O fluxo é esse:

  1. Usuário interage com o Copilot
  2. O Copilot chama um tópico com um Power Automate Flow embutido
  3. O Flow chama uma API REST com os dados recebidos
  4. O resultado volta e é exibido na conversa

Mão na massa: passo a passo

  • Crie seu Power Automate Flow
  • Vá para Power Automate
  • Crie um fluxo “instantâneo” com trigger “Copilot Studio”
  • Adicione uma ação: HTTP > Method: GET/POST, com a URL da sua API
  • Teste o fluxo com parâmetros simulados

  • Publique e conecte no Copilot Studio

  • No Copilot Studio, vá em “Tópicos”

  • Crie um novo tópico que chame o fluxo Power Automate

  • Mapeie variáveis de entrada (ex: ID do pedido) e de saída (ex: status)

Adicione validação e contexto

  • Você pode validar os dados com Power Fx e usar as respostas da API pra criar interações inteligentes.
  • Exemplo real: rastreamento de pedido
  • Cenário: Cliente pergunta: “Qual o status do pedido 12345?”
  • Resposta esperada: O Copilot consulta sua API de pedidos e responde: “Seu pedido 12345 está a caminho, com previsão de entrega para amanhã.”

E a segurança?

  • Configure autenticação com Bearer Token, API Key ou Azure AD OAuth
  • Nunca armazene informações sensíveis no copilot
  • Use variáveis seguras no Power Automate e configure run-only users

Cuidados e boas práticas

  • Timeouts: evite APIs muito lentas
  • Mensagens de fallback: sempre tenha uma resposta amigável se a API falhar
  • Logs: ative rastreabilidade no Flow para entender chamadas e falhas

Links úteis

Quer ver funcionando?

  • Posso montar um exemplo prático aqui de integração com uma API pública (ex: ViaCEP, GitHub, OpenWeather) usando o Copilot Studio. Só pedir!

Obrigado pela leitura!

Top comments (0)