Integração Twitch ↔ Discord

Como a Twitch conecta com a Ayami

Guia completo do módulo Twitch: o que ele faz, o que já dá pra configurar hoje, o que ainda está em construção e como cada parte funciona por trás dos panos.

Módulo em Beta Requer permissão de Administrador 1 conta Twitch principal por servidor
Como funciona

Da conta da Twitch até o aviso no Discord

O mesmo fluxo vale pra quem vai transmitir e pra quem só quer vincular a própria conta pra participar das missões.

1

Conecte a conta Twitch

Em Contas Conectadas no Dashboard, autorize a Ayami via OAuth da Twitch (o mesmo login usado pelo próprio site da Twitch).

2

Vincule ao servidor

Um Administrador abre /configurar → Criadores → Twitch → Conta no Discord, ou a mesma tela no Dashboard, e conecta o canal já autorizado.

3

A Ayami monitora o canal

A partir daí, a Ayami acompanha quando a live entra e sai do ar, os eventos do canal (follows, subs, bits, raids) e o chat, sem precisar de mais nada manual.

4

Configure o que quer usar

Ligue só os pedaços que fizerem sentido: anúncio de live, alertas de eventos, comandos do chat e/ou missões — tudo é opcional e independente.

Conta

Conectar, trocar ou remover a conta

É aqui que o servidor diz "esse é o canal da Twitch que a gente acompanha". Cada servidor tem só uma conta Twitch principal vinculada por vez — nenhum anúncio, alerta ou comando funciona sem uma conta conectada.

A conta é conectada uma vez em Contas Conectadas (OAuth da própria Twitch) e depois vinculada ao servidor pelo /configurar → Criadores → Twitch ou pelo Dashboard.

Conectar conta

Vincule ao servidor uma conta Twitch já autorizada em Contas Conectadas. A Ayami guarda o ID e o login do canal, não a senha.

Ativar/Desativar módulo

Liga ou desliga a integração pra este servidor quando quiser, sem perder nada do que já foi configurado.

Trocar ou remover conta

Substitui a conta vinculada por outra ou remove de vez a integração do servidor.

Anúncios de Live

Avise o Discord quando a live começa e termina

A Ayami detecta sozinha quando o canal entra e sai do ar e publica automaticamente uma mensagem no canal do Discord que você escolher.

Canal e cargo

Escolha o canal do Discord onde o aviso é publicado e, se quiser, um cargo pra mencionar quando a live começa.

Mensagens personalizadas

Reescreva as mensagens de início e de encerramento usando variáveis:

{streamer} {titulo} {categoria} {link}

Formato Rico ou Simples

Escolha entre um anúncio em embed rico (com capa da live e informações extras) ou só uma mensagem de texto simples.

Agenda

Agendamentos e lembretes de live

Painel reservado pra agendamentos, eventos automáticos e lembretes de transmissão.

Categoria já existe no menu do /configurar, mas ainda está em construção — por enquanto só mostra o aviso de "em breve".

Estatísticas

Histórico de lives, horas e audiência

Tudo calculado automaticamente a partir do que a Ayami observa durante as transmissões, sem precisar preencher nada manualmente.

Lives e horas transmitidas

Total de lives, duração média e data da última transmissão do canal.

Ranking de espectadores

Calculado por amostragem periódica do chat da Twitch, feita por um bot de chat dedicado da Ayami — mostra quem mais assiste ao longo do tempo.

Jogos mais transmitidos

Lista de categorias e jogos com mais tempo de transmissão no canal.

Metas

Metas de transmissão do streamer

Ideia é o próprio streamer definir objetivos (como horas transmitidas na semana ou número de lives no mês) e acompanhar o progresso.

Assim como a Agenda, essa categoria ainda está em construção no painel do Discord — não confundir com a "meta" (número alvo) que já existe hoje dentro de cada Missão.

Missões

Recompense quem assiste às lives

Missões de Twitch recompensam membros do servidor que assistem às transmissões — mas só contam pra quem vinculou a própria conta Twitch em Contas Conectadas, nunca por nome ou login digitado manualmente.

Tipos de missão

Assistir Transmissão, Acompanhar Duração, Sequência de Lives, Participação em Evento, Quantidade de Mensagens ou Personalizada.

Período e meta numérica

Limite por plano

Escolha o período (Única, Diária, Semanal ou Mensal) e defina o número-alvo de cada missão.

Recompensa

Emblema (Badge), Cargo do Discord ou Texto Personalizado — nunca moeda/saldo da economia. Também dá pra publicar um aviso num canal sempre que alguém completa.

A quantidade de missões de Twitch ativas ao mesmo tempo é limitada por plano — veja a tabela mais abaixo.

Comandos do Chat

Atalhos personalizados pro chat da Twitch

Comandos como !discord, respondidos direto no chat da Twitch pelo bot de chat dedicado da Ayami — não é preciso digitar nada no Discord.

Gatilho e resposta

Defina o gatilho (sem o "!") e o texto de resposta usando variáveis:

{user} {channel} {game} {titulo} {uptime} {url} {count}

Cooldown e permissão

Cooldown em segundos por comando (10s por padrão) e nível mínimo pra usar: Todo mundo, Inscritos, VIPs, Moderadores ou só o Streamer.

Ativar/Desativar

Ative ou desative cada comando individualmente sem perder o histórico de usos ({count} continua contando certinho).

Alertas de Eventos

Avise o Discord a cada evento da Twitch

Um alerta por tipo de evento, cada um com canal, mensagem e (quando faz sentido) um limiar mínimo pra disparar.

Novo Seguidor

Variáveis: {user}{channel}

Nova Inscrição / Renovação

Variáveis: {user}{tier}{months} (renovação também mostra os meses seguidos).

Inscrição Presenteada

Limiar mínimo

Variável {count} com a quantidade presenteada. Dá pra exigir uma quantidade mínima pra disparar.

Bits

Limiar mínimo

Variável {bits}. Defina a quantidade mínima de bits pra valer o alerta.

Raid

Limiar mínimo

Variável {viewers}. Também aceita um mínimo de espectadores pra disparar.

Canal e cargo por alerta

Cada alerta tem seu próprio canal do Discord e, se quiser, um cargo pra mencionar quando dispara.

A quantidade de alertas configurados ao mesmo tempo também varia por plano — veja a tabela logo abaixo.

Equipe

Quem pode administrar o módulo

Painel reservado pra delegar quem, além dos Administradores do servidor, pode mexer nas configurações da Twitch.

Ainda em construção — hoje, só quem tem permissão de Administrador no servidor consegue abrir e editar o módulo Twitch.

Configs que dependem do plano

Quantos Alertas e Missões cabem em cada plano

O resto do módulo (Conta, Anúncios, Estatísticas e Comandos) não tem limite por plano — o que varia é só a quantidade de Alertas e Missões de Twitch configurados ao mesmo tempo.

Plano Alertas de eventos Missões de Twitch
🌑 Gratuito 2 ao mesmo tempo 2 ao mesmo tempo
🌟 Nova Estrela 6 ao mesmo tempo 6 ao mesmo tempo
🌙 Lua Crescente 10 ao mesmo tempo 10 ao mesmo tempo
✨ Constellation Ilimitado Ilimitado

Pronto pra conectar sua Twitch?

Adicione a Ayami, conecte sua conta em Contas Conectadas e vincule ao servidor em poucos minutos.