Conectar fluxos a outros serviços com webhooks

Esse recurso está em visualização limitada.

Você pode usar uma etapa de webhook para fazer com que seus fluxos enviem informações a serviços externos, como apps de terceiros ou ferramentas internas da sua organização. Um webhook envia uma solicitação HTTP para um URL especificado por você. Por exemplo, é possível postar uma mensagem em um canal do Slack.

Important: When you add variables to third-party integration steps or add-on steps, they might contain your Google Account data, such as the contents of a message in Gmail or Chat, or event information from Calendar. The flow can then share your Google Account data with a third-party service. Make sure you trust the third-party service.

 

Adicionar uma etapa de webhook

1. Go to https://studio.workspace.google.com and create a flow.
2. No fluxo, clique em Adicionar etapa e em Enviar um webhook.
3. Configure a etapa de webhook com estas opções:
   1. URL do webhook ou da API (obrigatório): insira o URL de destino completo, com a parte http:// ou https://. Essa caixa exige um URL estático e não permite o uso de variáveis por questões de segurança. O URL é armazenado com proteção.
   2. Método (obrigatório): escolha o método HTTP da sua solicitação. O padrão é POST.
      1. GET: recupera dados de um URL.
      2. POST: envia dados para criar algo, como uma mensagem ou um registro.
      3. PUT: envia dados para substituir os dados atuais.
      4. PATCH: envia dados para fazer uma atualização parcial.
      5. DELETE: remove dados.
   3. Payload (opcional): insira o conteúdo do corpo da solicitação. O payload é ignorado para solicitações GET.

      Observação: o payload é enviado como texto simples. Qualquer formato pode ser usado, mas recomendamos o JSON para enviar dados facilmente para serviços da web. Se você usar uma variável para adicionar conteúdo ao payload, confirme que o conteúdo da variável não quebra o formato do payload. Nesta página, consulte Exemplos de payloads.

4. (Opcional) Adicione uma etapa para usar a resposta do webhook. A etapa de webhook gera a resposta como texto simples em uma variável que pode ser adicionada a etapas posteriores. Você pode adicionar uma etapa com tecnologia de IA que limpa ou extrai conteúdo da resposta.
5. (Opcional) Para testar seu fluxo, clique em Execução de teste. A execução de teste executa o fluxo uma vez, realizando ações reais para você ver o resultado. Selecione as condições de iniciação e clique em Iniciar. Saiba mais sobre as execuções de teste.
6. Quando o fluxo estiver pronto, clique em Ativar.

Exemplos de payloads

Método	Exemplo de payload
POST	{ "text": "Hello world!" }
GET	O payload é ignorado para solicitações GET
PUT	{ "contactId": "<variable>", "email": "[e-mail]" }
DELETE	{ "recordId": "<variable>", }
PATCH	{ "recordId": "<variable>", }

Monitorar a atividade do webhook

Depois que um fluxo é executado, você pode acessar a guia Atividade para ver o que o webhook fez.

• Se ele tiver funcionado, você verá os dados enviados e a resposta retornada.
• Se houver problemas, você vai receber uma mensagem de erro com o código completo e a resposta do URL de destino para ajudar na solução.

Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas às quais estão associados.