# Workflow Zapier

> Conecte a WayinVideo API ao Zapier para automatizar workflows de YouTube, Zoom, Google Sheets, AI clipping, resumo de vídeo e transcrição.

## Integração de Automação de Vídeo Zapier

Use o **Zapier** para conectar a WayinVideo API a apps como Google Sheets, Google Drive, YouTube, Zoom, Slack, Gmail, Airtable, Notion e HubSpot.

O Zapier é uma boa opção para workflows no-code leves em que um evento de negócio deve iniciar uma tarefa de processamento de vídeo: resumir uma nova gravação, transcrever uma reunião, criar candidatos a clipes a partir de um vídeo do YouTube ou enviar destaques para sua equipe.

Com a WayinVideo API e Webhooks by Zapier, você pode criar workflows de automação de vídeo com IA para operações de conteúdo, reaproveitamento de podcasts, follow-up de webinars, recaps de reuniões, revisão de clipes sociais e filas de pesquisa de vídeo.

> A WayinVideo não exige um app dedicado do Zapier. Você pode se conectar por **Webhooks by Zapier** usando sua API key da WayinVideo.

---

## O Que Você Pode Automatizar com Zapier

- **YouTube para clipes com IA**: detecte novos uploads de canais e gere candidatos a clipes com títulos, descrições, hashtags, timestamps e pontuações virais.
- **Resumos de gravações do Zoom**: transforme gravações de webinars ou reuniões em resumos estruturados e destaques de linha do tempo.
- **Filas de vídeo no Google Sheets**: processe linhas com URLs de vídeo e escreva os resultados de volta na mesma planilha.
- **Workflows de transcrição**: envie URLs de vídeo ou áudio para a [Video Transcription API](https://wayin.ai/pt/api-docs/video-transcription/) e armazene transcrições no Airtable, Notion ou CMS.
- **Workflows de revisão de clipes**: gere primeiro os metadados dos clipes e deixe sua equipe decidir quais clipes exportar com a [Clips Export API](https://wayin.ai/pt/api-docs/clips-export/).

---

## Como Funciona

A maioria dos workflows do Zapier segue este padrão:

1. **Trigger**: uma nova linha, arquivo, envio de formulário, vídeo ou gravação de reunião inicia o Zap.
2. **Enviar**: Webhooks by Zapier envia uma requisição HTTP para um endpoint da WayinVideo API.
3. **Aguardar / Consultar**: o Zapier verifica o endpoint de resultado até que `status` seja `SUCCEEDED` ou `FAILED`.
4. **Rotear**: o Zapier envia resumos, transcrições, metadados de clipes ou links de exportação para outro app.

Recomendamos consultar o status da tarefa a cada **30 segundos**.

---

## Exemplo: Resumir Vídeos do Google Sheets

Este workflow usa a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) para transformar URLs de vídeo em uma planilha em resumos estruturados e destaques de linha do tempo.

Trigger:
Nova linha no Google Sheets com uma coluna `video_url`.

Passos:
1. Use Webhooks by Zapier para chamar a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) com `POST /api/v2/summaries`
2. Armazene o `id` da tarefa retornado na mesma linha
3. Adicione um delay ou uma etapa de acompanhamento agendada
4. Chame `GET /api/v2/summaries/results/{id}` até que a tarefa chegue a `SUCCEEDED`
5. Escreva `summary`, `tags` e `highlights` de volta no Google Sheets

Ideal para:
Equipes editoriais, pesquisadores de conteúdo e profissionais de marketing que mantêm uma fila de vídeos em uma planilha.

### Requisição de Envio

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example"
  }'
```

### Requisição de Consulta

```bash
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/sum_proj_001 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
```

---

## Exemplo: Transformar Gravações do Zoom em Recaps de Equipe

Este workflow usa a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) para converter gravações de reuniões, webinars ou chamadas com clientes em recaps prontos para a equipe.

Trigger:
Nova gravação na nuvem do Zoom.

Passos:
1. Envie a URL da gravação para a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/)
2. Consulte o endpoint de resultado até que `status` seja `SUCCEEDED`
3. Envie o resumo e os destaques de linha do tempo para o Slack
4. Salve o resultado no Notion, Airtable, HubSpot ou Google Sheet

Ideal para:
Recaps de webinars, chamadas com clientes, reuniões internas, entrevistas e sessões de treinamento.

---

## Exemplo: Criar Candidatos a Clipes de Novos Vídeos do YouTube

Este workflow usa a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) para detectar candidatos a clipes curtos antes de sua equipe decidir o que exportar ou publicar.

Trigger:
Novo vídeo do YouTube em um canal.

Passos:
1. Envie a URL do YouTube para a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/)
2. Defina `enable_export` como `false` se você precisar apenas de timestamps e metadados dos clipes
3. Consulte o endpoint de resultado até que a tarefa seja concluída
4. Envie títulos, descrições, timestamps, hashtags e pontuações dos clipes para Airtable ou Google Sheets para revisão

Ideal para:
Criadores e equipes sociais que querem uma fila de revisão antes de renderizar ou publicar clipes.

### Requisição de Envio

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "enable_export": false
  }'
```

---

## APIs Recomendadas

| Objetivo do Workflow | API |
|----------------------|-----|
| Transformar vídeos longos em clipes curtos | [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) |
| Encontrar momentos específicos com uma consulta em linguagem natural | [Find Moments API](https://wayin.ai/pt/api-docs/find-moments/) |
| Gerar uma visão geral estruturada do vídeo e destaques de linha do tempo | [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) |
| Extrair transcrições com tempos e labels de falantes | [Video Transcription API](https://wayin.ai/pt/api-docs/video-transcription/) |
| Enviar arquivos locais de vídeo ou áudio antes do processamento | [Upload API](https://wayin.ai/pt/api-docs/upload/) |
| Renderizar ou reexportar clipes selecionados | [Clips Export API](https://wayin.ai/pt/api-docs/clips-export/) |

---

## Boas Práticas

- Armazene sua API key na conexão ou em campos secretos do Zapier. Não a coloque em templates públicos de Zap.
- Salve o `id` da tarefa retornado imediatamente para que retries não percam tarefas em andamento.
- Use delays do Zapier ou etapas de acompanhamento agendadas para evitar consultas frequentes demais.
- Sempre trate os estados `SUCCEEDED` e `FAILED`.
- Use `enable_export: false` quando sua equipe só precisa de timestamps e metadados para revisão. Exporte os clipes selecionados depois com a [Clips Export API](https://wayin.ai/pt/api-docs/clips-export/).

---

## FAQ

### A WayinVideo tem um app nativo do Zapier?

Você pode conectar a WayinVideo API ao Zapier por **Webhooks by Zapier**. Um app dedicado do Zapier não é necessário.

### O Zapier pode resumir vídeos do YouTube com a WayinVideo?

Sim. Use um trigger do YouTube ou uma linha do Google Sheets contendo uma URL do YouTube, envie para a [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) e escreva o resumo e os destaques gerados no app escolhido.

### O Zapier pode criar clipes curtos a partir de vídeos longos?

Sim. Envie a URL do vídeo para a [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/). Você pode retornar apenas metadados de clipes para revisão ou habilitar a exportação para renderizar clipes curtos para download.

### Com que frequência o Zapier deve verificar o status da tarefa?

Recomendamos verificar o status da tarefa a cada **30 segundos**. Armazene o `id` da tarefa para que cada etapa de consulta recupere o resultado correto.
