# Roteiro UGC

> Escreva a abertura, os trechos e o encerramento de um vídeo UGC a partir do nome ou do site do produto e de até 8 capturas de tela.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/ugc-script

O nó **Roteiro UGC** escreve o que o criador diz em um vídeo UGC: a **linha de abertura**, os **trechos** e a **linha de encerramento**. Ele lê até 8 capturas de tela e o nome ou o site do produto que você informa. Ele verifica o roteiro pelas regras do vídeo e o reescreve quando o roteiro quebra uma delas.

- Found in: Video › UGC Video
- API type: `ugc-script`

O Roteiro UGC também escolhe a categoria de produto para a qual o [**Criador UGC**](https://nodaro.ai/docs/nodes/video/ugc-creator) gera o criador. O próximo nó costuma ser o [**Clipes UGC**](https://nodaro.ai/docs/nodes/video/ugc-clips), que divide o roteiro em clipes.

O Roteiro UGC é executado só no Nodaro Cloud. Em qualquer outra instalação, todo nó UGC falha antes que algo seja reservado, com a mensagem “Os vídeos UGC são um recurso do Nodaro Cloud e não estão disponíveis nesta instância.”

## Quando usar
- Você quer um vídeo curto de um criador que fala sobre o seu produto ou o seu site.
- Você tem capturas de tela do seu site ou app e quer que cada uma apareça como um cartão enquanto o criador fala dela.
- Você quer um roteiro que já caiba na duração do vídeo.

Para um roteiro com várias cenas, com prompts de imagem, diálogos e climas musicais, use o [**Gerar roteiro**](https://nodaro.ai/docs/nodes/video/generate-script).

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Vídeo UGC › Roteiro UGC**.

### Informar o produto
Conecte um nó [**Texto**](https://nodaro.ai/docs/nodes/automate/text) a **Nome do produto ou site**. Digite o nome do produto ou cole o site dele.

### Adicionar as capturas de tela
Conecte de 3 a 8 nós [**Enviar imagem**](https://nodaro.ai/docs/nodes/image/upload-image) às entradas **Captura de tela 1** a **Captura de tela 8**, na ordem em que o criador deve falar delas. Se quiser, conecte uma foto do produto a **Foto do produto**.

### Definir a duração e executar
Abra o painel de configurações e defina **Duração do vídeo (segundos)**. Clique em **Executar**. As linhas do roteiro aparecem no nó.

Workflow: O Roteiro UGC escreve o roteiro a partir do nome do produto e das capturas de tela. A categoria dele vai para o Criador UGC, e o roteiro vai para o Clipes UGC.

- Texto → Roteiro UGC (nome do produto ou site)
- Enviar imagem → Roteiro UGC (captura de tela)
- Roteiro UGC → Criador UGC (categoria)
- Roteiro UGC → Clipes UGC (texto)
- Criador UGC → Clipes UGC (criador)

## Entradas
| Entrada | Obrigatória | O que conectar |
| --- | --- | --- |
| **Nome do produto ou site** | Sim | Texto. Um nome de até 80 caracteres é usado como a marca, exatamente como foi digitado. Uma descrição mais longa, de até 300 caracteres, é lida como contexto, e o roteiro tira dela o nome da marca. Sem esta entrada, o nó falha com a mensagem “Adicione o nome do produto ou o site.” |
| **Captura de tela 1** a **Captura de tela 8** | Não | Imagens, na ordem dos cartões. As entradas vazias são ignoradas. |
| **Foto do produto** | Não | Uma imagem do produto. Com uma foto do produto, a linha de encerramento pode mostrar o criador segurando o produto. |

### Quantas capturas de tela
- **De 3 a 8 capturas de tela:** um trecho para cada uma, na ordem das entradas, começando pela Captura de tela 1. Cada captura de tela aparece como um cartão enquanto o criador fala dela. O [**Cartões UGC**](https://nodaro.ai/docs/nodes/video/ugc-cards) define os tempos dos cartões.
- **1 ou 2 capturas de tela** são descartadas. O vídeo é o criador falando, sem cartões, e as Notas do Cartões UGC dizem isso.
- **Nenhuma captura de tela:** o mesmo vídeo do criador falando.

O Roteiro UGC lê as capturas de tela como imagens. Ele nunca visita o site.

## Saídas
| Saída | O que leva |
| --- | --- |
| **Texto** | O roteiro, em JSON, para a entrada **Texto** do [**Clipes UGC**](https://nodaro.ai/docs/nodes/video/ugc-clips). |
| **Categoria** | A categoria do produto, em texto simples, para a entrada **Categoria do produto** do [**Criador UGC**](https://nodaro.ai/docs/nodes/video/ugc-creator), ou para qualquer entrada de texto. |

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Duração do vídeo (segundos)** | Quanto o vídeo deve durar, de 4 a 300 segundos. O padrão é 15. O roteiro é escrito para essa duração. |
| **Idioma** | O idioma em que o roteiro é escrito e falado: **Inglês** (o padrão) ou **Hebraico**. Um vídeo em hebraico precisa do [**Finalização UGC**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips) antes que os clipes sejam juntados. |
| **Manter este roteiro** | Desativado por padrão. Quando está ativado, a próxima execução repassa o último roteiro sem escrever de novo, sem custo. Enquanto o roteiro é mantido, a duração continua sendo a do próprio roteiro mantido. Para mudar a duração, desative **Manter este roteiro**. |

As configurações também dizem em quantas rodadas o roteiro foi escrito, por exemplo “Escrito em 2 rodadas”.

### Como o roteiro é verificado
O Roteiro UGC verifica o roteiro pelas regras do vídeo. Quando o roteiro quebra uma regra, o nó o reescreve a partir do que a verificação encontrou. Ele tenta três vezes ao todo: a primeira escrita e até duas reescritas.

### Editar as linhas
Depois de uma execução, as configurações mostram as linhas do roteiro: **Linha de abertura**, cada trecho (**Trecho 1**, **Trecho 2** e assim por diante) e **Linha de encerramento**.

1. Pressione **Editar** e mude as palavras das linhas.
2. Pressione **Salvar** para gravá-las no roteiro. Salvar ativa **Manter este roteiro**, então a próxima execução usa as suas linhas.
3. Pressione **Cancelar** para deixar o roteiro como estava.

Só as palavras das linhas podem ser editadas. Uma linha em branco é recusada, por exemplo com a mensagem “A linha do trecho 2 está vazia.”

Uma linha acima do limite de caracteres do roteiro também é recusada, por exemplo com a mensagem “A linha do trecho 2 está longa demais — use no máximo … caracteres.”

O [**Clipes UGC**](https://nodaro.ai/docs/nodes/video/ugc-clips) verifica de novo um roteiro editado antes que qualquer clipe seja pago. Um roteiro que quebra uma regra faz o Clipes UGC falhar com a mensagem “O roteiro precisa de alterações:”, seguida de cada problema e da correção dele.

### Em um app publicado
A duração pode ser uma entrada do app, **Duração do vídeo (segundos)**. Ela é um controle deslizante de 4 a 300 segundos, ou uma escolha entre as durações que o app permite. Publicado como app, o tutorial **Vídeo UGC a partir do seu site** oferece 15, 20 e 25 segundos.

## Créditos
O Roteiro UGC cobra um preço fixo por execução, não importa quantas reescritas ele faça. O editor mostra o preço no botão **Executar** antes de a execução começar.

- Uma execução que não consegue cumprir as regras depois de três tentativas é reembolsada. Ela falha com a mensagem “O roteiro não conseguiu cumprir as regras do vídeo depois de três tentativas:”, seguida do que ainda estava errado.
- Uma execução que falha por qualquer outro motivo também é reembolsada.
- Um roteiro mantido é repassado sem custo. Os clipes depois dele recebem o preço pela duração e pelos cartões de captura de tela do próprio roteiro mantido.

Veja [Preços no editor](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor) para o preço do vídeo inteiro.

## Dicas
- **Envie as capturas de tela na ordem da fala.** A ordem dos cartões é a ordem das entradas de captura de tela.
- **Mantenha um roteiro de que você gostou.** Ative **Manter este roteiro**, ou edite as linhas e salve. A próxima execução do workflow inteiro repassa então o roteiro em vez de pagar por um novo.
- **Use de 3 a 8 capturas de tela para ter cartões.** Com menos, o vídeo fica sem cartões.
- **Publicar leva o roteiro vazio.** Um template publicado com **Incluir os resultados desta execução** mostra as linhas faladas como exemplo, até que a pessoa que o copia escreva um primeiro roteiro.

## Solução de problemas
| Mensagem ou problema | Causa e solução |
| --- | --- |
| “Adicione o nome do produto ou o site.” | Nada está conectado a **Nome do produto ou site**. Conecte um nó Texto com o nome ou o site. |
| “O roteiro não conseguiu cumprir as regras do vídeo depois de três tentativas:” | O roteiro ainda quebrava uma regra depois de duas reescritas. A execução é reembolsada. Mude a duração, o texto do produto ou as capturas de tela e execute de novo. |
| “A linha do trecho 2 está vazia.” | Uma linha que você editou está em branco. Escreva a linha ou pressione **Cancelar**. |
| “A linha do trecho 2 está longa demais — use no máximo … caracteres.” | Uma linha que você editou passa do limite. Encurte-a. |
| A configuração de duração não pode ser mudada. | **Manter este roteiro** está ativado. Desative-o para mudar a duração. |
| O vídeo não tem cartões. | Menos de 3 capturas de tela estão conectadas. Adicione de 3 a 8 capturas de tela. |

## Pela API
O Roteiro UGC chama `POST /v1/ugc/script` quando é executado, e a rota responde com o id de uma tarefa. Os formatos de requisição e de resposta das rotas UGC pertencem aos nós e podem mudar entre versões. Para fazer um vídeo UGC a partir de código, execute um workflow ou um app publicado que contenha os nós UGC.

Uma requisição de execução pode definir o `targetDurationSec` do Roteiro UGC, de 4 a 300. Em um nó UGC, uma execução também pode definir só `source`, `gender` e `photoUrl` do Criador UGC. Qualquer outro campo em um nó UGC responde `400 locked_field`. Veja [Workflows](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values) e [MiniApps](https://nodaro.ai/docs/concepts/apps#embed-a-miniapp-or-run-it-from-code).

Assistentes de IA conectados por MCP usam ferramentas UGC próprias, como `build_ugc_clips`. A receita ugc-website, carregada com `get_recipe`, explica essas ferramentas. Veja [Receitas de conteúdo](https://nodaro.ai/docs/mcp/recipes).

## Perguntas frequentes

### O que o nó Roteiro UGC faz?

O Roteiro UGC escreve o que o criador diz em um vídeo UGC: a linha de abertura, os trechos e a linha de encerramento. Ele lê o nome ou o site do seu produto e até 8 capturas de tela, e verifica o roteiro pelas regras do vídeo.

### O Roteiro UGC visita o meu site?

Não. O Roteiro UGC lê as capturas de tela como imagens e nunca visita o site. Digite o nome do produto ou cole o site dele como contexto.

### Quantas capturas de tela devo enviar?

Envie de 3 a 8 capturas de tela. Cada uma recebe um trecho e aparece como um cartão enquanto o criador fala dela. Com 1 ou 2 capturas de tela, ou nenhuma, o vídeo é o criador falando, sem cartões.

### Quantos créditos o Roteiro UGC custa?

O Roteiro UGC cobra um preço fixo por execução, não importa quantas reescritas ele faça. Uma execução que falha é reembolsada, e um roteiro mantido não custa nada. O editor mostra o preço antes de a execução começar.

### Posso editar o roteiro?

Sim. Depois de uma execução, pressione Editar no painel de configurações, mude as palavras das linhas e pressione Salvar. Salvar ativa Manter este roteiro, então a próxima execução usa as suas linhas.