Adicionar e importar doações

Vem com o strAImer: este módulo é instalado junto com o aplicativo, então não há nada para baixar. Ele aparece em Catálogo de Módulos → Integrados.

O que é isto

O dinheiro nem sempre vem por um serviço conectado: um espectador manda direto para você, entrega em dinheiro, ou o serviço perde uma doação. Adicionar doação registra essa doação nas Estatísticas manualmente, e Importar de arquivo traz um histórico de doações exportado do DonationAlerts ou do DonatePay. Os dois botões ficam na aba Dados das Estatísticas, ao lado dos chips de filtro.

Como configurar

1. Adicionar doação abre a janela Adicionar uma doação. Ela pede o Serviço (os seus serviços de doação instalados, ou Outro: cartão, dinheiro, transferência), o Doador (vazio, fica Anônimo), o Valor e a Moeda (a sua moeda base vem primeiro), a Data e hora (agora, a menos que você mude; uma data no futuro é recusada) e uma Mensagem opcional. Adicionar salva, e em Dados a linha dela diz "adicionada manualmente". A doação cai no cartão da transmissão que estava rolando naquela hora; fora de qualquer transmissão ela não fica em nenhum cartão, mas conta nos tops do mesmo jeito.
2. Abaixo dos campos fica Contar como doação ao vivo, desmarcado. Desmarcado, a dica diz "Entra só nas estatísticas e nos tops de doadores. Os alertas ficam em silêncio." Marcado, a doação sai como se tivesse acabado de chegar: "Conta como uma doação nova: o alerta, a voz e os cenários reagem, o chat bot responde no chat, e metas, carrossel, leilão e timer contam a doação." Marque para dinheiro que deve aparecer na tela agora, e deixe desmarcado para o histórico.
3. A mesma janela abre pelo + no cabeçalho do bloco Stream: Eventos no Painel de Controle, então dá para adicionar uma doação no meio da live sem sair do painel. O botão aparece enquanto esse bloco mostra doações.
4. Importar de arquivo recebe uma exportação do DonationAlerts (um arquivo .xls) ou do DonatePay (um arquivo .xlsx); a dica que aparece ao apontar para o botão diz o mesmo. Primeiro baixe a exportação no painel do próprio serviço, depois pressione o botão e escolha o arquivo na janela que abrir. Nada é gravado ainda: Importar do {service} mostra o nome do arquivo, quantas doações são novas com as primeiras delas, quantas já estão nas estatísticas e as linhas que pulou com o motivo, por exemplo um pagamento que não foi concluído. Importar grava as novas e avisa "Doações adicionadas: {count}."; Cancelar não grava nada. Um histórico longo leva alguns minutos, e a janela fica aberta até terminar.
5. As doações importadas entram nos totais das transmissões, em Principais doadores e nas listas de maiores doadores no OBS. Elas não tocam alertas nem mexem em metas, carrossel ou leilão: isso é histórico, não dinheiro novo. Importar o mesmo arquivo duas vezes não adiciona nada na segunda. Uma doação que o app já pegou ao vivo é reconhecida e não é duplicada, assim como uma que você adicionou manualmente nesse serviço com o mesmo doador, valor e moeda com menos de um dia de diferença: a importação fica com ela em vez de adicionar uma segunda cópia.
6. Uma doação adicionada manualmente ou importada é excluída como qualquer outro registro: aponte para a linha dela em Dados e pressione ✕. Uma importada, ou adicionada sem Contar como doação ao vivo, nunca contou para metas, carrossel ou leilão, então excluí-la não tira nada deles. Uma adicionada como ao vivo devolve o que deu.

O que não pode fazer

• Importar de arquivo lê apenas as exportações do DonationAlerts e do DonatePay. Qualquer outro arquivo, inclusive a exportação de outro serviço, é recusado com "Este arquivo não é uma exportação de doações do DonationAlerts nem do DonatePay. Outros serviços ainda não podem ser importados." Não há importação de assinaturas, bits ou chat.
• O app não baixa a exportação para você: ela é feita no painel do próprio serviço, e o app só lê o arquivo.
• Não dá para fazer uma doação importada tocar um alerta ou contar para uma meta depois. Para dinheiro que deve fazer isso, use Adicionar doação com Contar como doação ao vivo.
• Uma doação não pode ser editada. Para corrigir, exclua e adicione de novo. Manualmente só se adicionam doações: não uma transmissão, uma assinatura ou outro evento.
• Um serviço desmarcado em Contar doações de, na aba Configurações das Estatísticas, não pode ser usado aqui, nem manualmente nem por arquivo. A janela avisa; marque o serviço primeiro.
• O DonatePay não entrega ao app um histórico próprio, então um arquivo é o único jeito de trazer as doações antigas dele. O DonationAlerts e o DonateX carregam o histórico sozinhos; o guia "Estatísticas da transmissão" explica Reconstruir histórico de doações.