O overlay é a camada que exibe as doações em tempo real na sua live. Você pode usar a Donaty como Browser Source no OBS.

1. No painel da Donaty, acesse Configurações > Overlay ( abrir página de overlay ).
2. Copie a URL do overlay que contém seu username e token (algo como https://donaty.com.br/overlay/username/token ).
3. Abra o OBS e clique em + > Fonte > Browser .
4. Dê um nome para a fonte (por exemplo, Donaty Overlay) e clique em OK.
5. Cole a URL do overlay da Donaty no campo URL.
6. Defina a resolução da fonte para corresponder ao tamanho da sua cena (por exemplo, 1920x1080).
7. Clique em OK e posicione o overlay onde desejar na cena.

Quando uma nova doação for recebida, o alerta aparecerá automaticamente no overlay do OBS em tempo real.

A chave Pix é a conta destino dos seus saques. Sem ela cadastrada, você até recebe doações, mas não consegue solicitar saque do saldo.

1. No painel, acesse Monetização > Chave Pix ( abrir cadastro de chave Pix ).
2. Selecione o tipo da chave: CPF, CNPJ, e-mail, telefone ou chave aleatória.
3. Informe a chave exatamente como ela está cadastrada no seu banco — qualquer divergência impede a transferência.
4. Salve. A chave passa a ser usada automaticamente em todos os próximos saques.

Você pode atualizar a chave a qualquer momento. Saques já solicitados continuam usando a chave que estava no ato da solicitação.

Os saques permitem transferir o saldo disponível das suas doações para a sua conta bancária ou chave Pix cadastrada.

1. Acesse o painel da Donaty e clique em Saques ( abrir página de saques ).
2. Verifique o saldo disponível para saque e as regras de saque (valor mínimo, prazo, taxas etc.).
3. Clique em Solicitar saque e informe o valor desejado (dentro do limite disponível).
4. Confirme os dados da sua conta ou chave Pix que receberá o valor.
5. Finalize a solicitação e aguarde o processamento dentro do prazo informado na plataforma.

Você poderá acompanhar o status de cada saque (pendente, pago, rejeitado) na mesma tela de saques.

O QR Code é uma página/arte com seu QR pronta para ser exibida na live ou em redes sociais. Ao escanear, o viewer cai direto no seu checkout de doação.

1. No painel, acesse Janelas > QRCode ( abrir personalização do QR Code ).
2. Escolha um template e ajuste cores de fundo e do texto para combinar com a sua marca.
3. (Opcional) Adicione CSS personalizado para refinar a arte do QR Code.
4. Use a página pública do QR (URL no formato /qrcode/seu-username ) como Browser Source no OBS ou em uma cena fixa.
5. Toda doação confirmada continua vindo pelo seu checkout normal — o QR é só um atalho visual.

Dica: deixe o QR sempre visível em uma cena de "Bem-vindo" ou "Pausa" para incentivar novas doações.

A página de checkout é onde o viewer define o valor, mensagem e gera o Pix. Você pode personalizar cores, textos e regras de uso para deixar tudo com a cara da sua live.

1. No painel, acesse Configurações > Checkout ( abrir personalização de checkout ).
2. Ajuste o tema (cores, gradiente de fundo, fontes) de acordo com a identidade da sua live.
3. Personalize textos como título, subtítulo e mensagens de ajuda ao doador.
4. Em Regras do checkout (abrir regras) configure o valor mínimo e se o fluxo deve solicitar CPF, telefone ou e-mail do apoiador.
5. Se disponível, adicione CSS personalizado para controlar detalhes visuais avançados.
6. Salve as alterações e acesse sua página pública de doação para conferir o resultado.

Todas as alterações são aplicadas em tempo real na página de doação usada pelos seus viewers.

O alerta de doação é o pop-up que aparece no overlay quando alguém doa. Ele pode exibir avatar, nome, valor, mensagem e animações personalizadas.

1. No painel, acesse Configurações > Alertas ( abrir configurações de alertas ).
2. Escolha o layout do alerta (posição do avatar, texto, valor, barra de progresso etc.).
3. Defina quais informações aparecerão no alerta: nickname, mensagem, valor, meta, ranking etc.
4. Ajuste cores, bordas, sombras e duração do alerta na tela.
5. Use o botão de teste de alerta para ver uma prévia no seu overlay (OBS precisa estar aberto com a fonte do overlay ativa).

Assim que você salvar, os novos alertas serão usados automaticamente para todas as próximas doações.

O som do alerta é o que toca quando uma doação chega. A Donaty também faz a leitura automática (TTS) da mensagem do doador, com vozes selecionáveis no checkout.

1. Acesse novamente Overlay > Alertas .
2. Localize a seção de som do alerta ou áudio do alerta.
3. Faça o upload do arquivo de áudio desejado (recomendado em MP3 / OGG / WAV ).
4. Ajuste o volume do alerta para equilibrar com o áudio do jogo, voz e demais fontes da live.
5. Habilite a leitura por voz (TTS) da mensagem e escolha a voz padrão. O doador pode trocar a voz/ouvir uma amostra no próprio checkout.
6. Use o botão de testar som para ouvir o resultado diretamente no overlay.

Dica: escolha um som curto (1–3 segundos) para não competir com a leitura da mensagem por TTS.

A moderação ajuda a evitar que mensagens e áudios indevidos apareçam no overlay. Você define termos proibidos, ativa filtros de IA e bloqueia músicas ou citações de marcas.

1. No painel, acesse Janelas > Moderação ( abrir moderação ).
2. Ative o bloqueio por termos proibidos para mensagens e/ou áudios. A lista vem com termos padrão e você pode adicionar/remover livremente.
3. (Opcional) Habilite o filtro de IA para mensagens e áudios — útil para pegar conteúdo ofensivo escrito de forma criativa.
4. Ative bloquear músicas e bloquear menções a marcas se quiser evitar problemas de copyright durante a live.
5. Salve. As regras passam a valer imediatamente, sem precisar reiniciar o overlay.

Mensagens e áudios bloqueados ficam no histórico de doações com o motivo, para você revisar depois se quiser.

As metas aparecem como uma barra de progresso no overlay e somam automaticamente as doações pagas enquanto a meta estiver ativa. Você pode ter mais de uma meta ativa ao mesmo tempo.

1. No painel, acesse Principal > Metas ( abrir metas ).
2. Clique em Nova meta e informe título, descrição, valor alvo e (opcional) data de expiração.
3. Ao salvar, a meta entra como ativa e já passa a contabilizar as doações. Para zerar o progresso de um novo ciclo, use a opção Reiniciar progresso.
4. Adicione no OBS a fonte do overlay de meta, com URL no formato /overlay/username/token/goal .
5. Quando a meta for batida, ela é marcada como concluída automaticamente — você pode ativar/desativar manualmente se quiser pausar a contagem.

Dica: marque a opção "Página de campanha" ao criar a meta para ganhar uma página pública dedicada (vaquinha — veja o tutorial mais abaixo).

O cronômetro permite fazer um subathon: cada doação adiciona tempo à sua live. Você define a regra (segundos por real ou faixas por valor) e o overlay mostra o relógio em tempo real.

1. No painel, acesse Janelas > Cronômetro ( abrir cronômetro ).
2. Habilite o cronômetro e defina o tempo inicial (formato HHH:MM, ex. 012:00 para 12h).
3. Escolha a regra de adição: segundos por real (linear) ou faixas por valor (ex.: ≥ R$10 adiciona 5min, ≥ R$50 adiciona 30min).
4. (Opcional) Ative o acréscimo de tempo por subs/bits da Twitch ou Kicks se você usa as integrações dessas plataformas.
5. Adicione no OBS a fonte do overlay com URL no formato /overlay/username/token/marathon .

Toda doação confirmada soma tempo automaticamente. Você pode pausar/retomar e ajustar a configuração durante a live sem reiniciar o overlay.

Você pode criar enquetes com voto gratuito ou ponderado por Pix — nesse modo, o valor doado vira peso para a opção escolhida pelo doador.

1. No painel, acesse Janelas > Enquetes ( abrir enquetes ).
2. Informe o título e até quatro opções de resposta.
3. Escolha o modo: voto gratuito (uma sessão = um voto) ou voto por doação (o doador escolhe a opção no checkout).
4. Defina a duração — preset (ex.: 10 min) ou data/hora final personalizada.
5. Personalize cores (fundo, texto e barras) do widget e adicione no OBS a fonte com URL no formato /overlay/username/token/poll .

Ao final, a enquete trava e mostra o resultado. Você pode encerrar a qualquer momento ou criar uma nova quando quiser.

O ranking é um overlay que mostra os top apoiadores em tempo real. Útil para valorizar quem mais contribui e estimular o engajamento.

1. No painel, acesse Janelas > Ranking ( abrir ranking ).
2. Escolha o período a considerar: total, hoje, semana ou mês.
3. Defina a direção (vertical ou horizontal) e o número máximo de posições (até 50).
4. Personalize a cor do texto e o nome do widget para combinar com o resto do overlay.
5. Adicione no OBS a fonte com URL no formato /overlay/username/token/ranking .

O ranking atualiza sozinho a cada nova doação confirmada — sem necessidade de recarregar a fonte no OBS.

A janela de texto é um popup customizável para exibir mensagens, avisos ou textos livres no overlay durante a live.

1. No painel, acesse Overlay > Janela de texto ( abrir janela de texto ).
2. Escolha o template padrão (cartão, faixa etc.), a posição na tela e a duração em milissegundos.
3. (Opcional) Adicione CSS personalizado para refinar o visual da janela.
4. Adicione no OBS a fonte com URL no formato /overlay/username/token/text .
5. Use o disparo manual no painel (ou via API/automação) para mostrar a mensagem no momento que quiser.

Útil para anunciar promoções, regras de chat, links de redes sociais ou qualquer aviso pontual sem precisar mexer na cena do OBS.

A vaquinha é uma página pública dedicada a uma meta específica, com história, barra de progresso e checkout próprio. Ideal para campanhas pontuais (compra de equipamento, causas sociais, eventos especiais).

1. No painel, acesse Principal > Metas e clique em Nova meta.
2. Marque a opção Página de campanha. Ao habilitar, surge um campo de slug (URL amigável) e um editor de história.
3. Preencha um título envolvente, valor alvo, data limite (opcional) e a história/contexto da campanha.
4. Salve. A vaquinha fica acessível em /seu-username/campanha/slug-da-campanha .
5. Compartilhe o link com sua audiência. As doações da campanha contam tanto na meta quanto no seu saldo normal.

A página da campanha tem o mesmo motor do checkout normal — então herda automaticamente a sua personalização visual e regras (CPF, telefone, etc.).

Os sorteios permitem premiar quem doou — você define o prêmio, a regra de elegibilidade e roda o sorteio ao vivo, com animação e página pública para a audiência acompanhar.

1. No painel, acesse Monetização > Sorteios ( abrir sorteios ).
2. Crie um novo sorteio com título, prêmio (texto ou produto) e regras de participação (período, valor mínimo doado, número de tickets por valor).
3. Compartilhe a página pública do sorteio (formato /seu-username/sorteio/slug ) com sua audiência.
4. Quando for a hora de sortear, abra a tela de realização do sorteio e rode o sorteio ao vivo. A audiência vê em tempo real a animação na página pública.
5. O ganhador recebe um link público para confirmar dados de entrega (endereço, contato) — você acompanha tudo na aba Ganhadores.

Você pode clonar sorteios anteriores para criar edições recorrentes mantendo as mesmas regras.

As assinaturas dão aos seus apoiadores uma forma de te apoiar de forma recorrente, com planos personalizados por valor e benefícios.

1. No painel, acesse Monetização > Assinaturas ( abrir planos ).
2. Clique em Novo plano e configure: nome, valor mensal, descrição e benefícios que o assinante recebe.
3. Defina os termos de serviço do plano (cancelamento, política, etc.) — eles ficam disponíveis em uma página pública dedicada.
4. Publique. A página pública do plano fica em /seu-username/sub .
5. Acompanhe assinantes ativos, valor mensal recorrente e cancelamentos diretamente na tela Assinaturas.

Você pode ter quantos planos quiser (ex.: Bronze, Prata, Ouro), cada um com benefícios diferentes.

As recompensas aparecem no checkout como uma "tabela de níveis" — o doador vê o que ele desbloqueia ao doar a partir de um determinado valor (badge no perfil, mensagem destaque, benefício especial etc.).

1. No painel, acesse Recompensas ( abrir recompensas ).
2. Crie uma recompensa com nome, descrição, valor mínimo e tipo (badge, mensagem destacada, alerta especial etc.).
3. Adicione os benefícios que o doador recebe e escolha um ícone para identificar visualmente.
4. Use ordem de exibição para controlar a sequência (geralmente do menor para o maior valor) e ative/desative recompensas conforme a campanha.
5. As recompensas aparecem automaticamente no checkout do doador.

Recompensas são uma forma simples de gamificar a doação e estimular o doador a subir um nível.

A página de apoiadores consolida todo mundo que já doou pra você: total doado, última doação, histórico e ações de moderação.

1. No painel, acesse Principal > Apoiadores ( abrir apoiadores ).
2. Use a busca por nome/e-mail/CPF e ordene por total doado, doação mais recente etc.
3. Clique em um apoiador para ver o histórico completo de doações dele.
4. Se necessário, use bloquear apoiador a partir de uma doação específica — ele deixa de conseguir usar o seu checkout (regra das doações).

Use essa tela para reconhecer seus top apoiadores publicamente e tomar decisões de moderação mais bem informadas.

A equipe permite que outras pessoas (editores, moderadores, gerente de comunidade) acessem o painel do seu canal com permissões específicas — sem compartilhar sua senha.

1. No painel, acesse Conta > Equipe ( abrir equipe ).
2. Informe o e-mail da pessoa que você quer adicionar.
3. Selecione as permissões que ela terá (ex.: ver doações, moderar mensagens, gerenciar metas, ver saques etc.).
4. Se a pessoa já tem conta na Donaty, ela é adicionada na hora. Caso contrário, recebe um convite por e-mail com link temporário para criar a conta.
5. A pessoa adicionada pode alternar entre o canal dela e o seu pelo seletor "Conta ativa" no topo da barra lateral.

Você pode editar permissões ou remover membros a qualquer momento. Convites pendentes aparecem na aba Convites.

Para a parte de doações, o fluxo recomendado é: usar o overlay da Donaty no OBS e, quando necessário, registrar eventos externos (Super Chat, Bits, doações de outras plataformas) via Importar doações.

1. No painel, acesse Integrações ( abrir integrações ).
2. Para Twitch: entre em Integrações > Twitch e clique em Conectar Twitch.
3. Para YouTube Live (Super Chat), Kick, LivePix e outras: acesse Integrações > Importar doações ( abrir importação ), ative a plataforma desejada e copie a URL do webhook.
4. Configure seu integrador (Zapier/Make/n8n/bot próprio) para enviar POST JSON no formato: external_id, donor_name, amount, message (opcional) .
5. (Opcional) Defina um Segredo HMAC no card para exigir o cabeçalho X-Import-Signature: sha256=<hmac do corpo> .
6. Teste a integração disparando um evento real (ex.: Super Chat) ou enviando um POST de teste e verifique se o alerta aparece no overlay.

Se você está configurando pela primeira vez, siga também o tutorial detalhado em docs/INTEGRATIONS.md (índice) e os arquivos em docs/integrations/.