POST /chat

Mensagem ou comando nativo da Twitch no chat — inclusive /announce, /timeout e /marker.

channel é opcional — sem ele, manda no canal operado. Texto começando com / é comando da Twitch: quem decide se aceita é ela, seguindo as regras daquele comando no canal de destino.

curl -X POST -H "Authorization: Bearer $ASRUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"oi chat","channel":"asrus12"}' \
  https://www.asrus.app/api/v1/chat

A Twitch às vezes aceita a chamada e descarta a mensagem (termo bloqueado, modo seguidores, conta restrita). Por isso a resposta é 200 com sent: false e o motivo — confira o campo, não só o status:

{ "sent": false, "dropReason": "Your message was blocked... (channel_settings)",
  "channel": "asrus12", "sentAs": "asrus12", "isCommand": false }

Comandos nativos da Twitch via /chat

O endpoint aceita qualquer texto que a conta autorizada poderia digitar no chat. Se começar com /, a Twitch interpreta como comando nativo. A API só transporta a mensagem: a permissão, o cargo e as regras do canal continuam sendo conferidos pela Twitch.

Use channel para escolher o canal de destino quando a chave tiver acesso a mais de um canal. Sem ele, a mensagem vai para o canal operado pela chave.

comandousopermissão normalmente necessária
/announce textoAnúncio destacado no chatmoderador
/shoutout canalEnviar shoutout para outro canalmoderador
/ban login motivoBan permanentemoderador
/timeout login 600 motivoTimeout em segundosmoderador
/unban loginRemover ban ou timeoutmoderador
/clearLimpar o chatmoderador
/slow 10Modo lento, em segundosmoderador
/followers 30mSomente seguidoresmoderador
/subscribers / /emoteonlyRestringir o chatmoderador
/raid canalIniciar raiddono ou permissão da Twitch
/unraidCancelar raid pendentedono ou permissão da Twitch
/marker textoCriar marcador no VODdono ou editor
/commercial 60Rodar comercialafiliado/parceiro
# anúncio
curl -X POST -H "Authorization: Bearer $ASRUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"/announce Voltamos em 5 minutos","channel":"asrus12"}' \
  https://www.asrus.app/api/v1/chat

# timeout e marcador
curl -X POST -H "Authorization: Bearer $ASRUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"/timeout fulano 600 spam"}' \
  https://www.asrus.app/api/v1/chat

curl -X POST -H "Authorization: Bearer $ASRUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"/marker clutch da rodada"}' \
  https://www.asrus.app/api/v1/chat

A resposta informa isCommand: true. Mesmo com HTTP 200, a Twitch pode descartar o comando por falta de cargo, escopo, configuração do canal ou sintaxe: nesse caso confira sent e dropReason. Quando precisar de uma mensagem de erro mais previsível, prefira os endpoints específicos de /vips, /moderators e /bans.