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 }
/chatO 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.
| comando | uso | permissão normalmente necessária |
|---|---|---|
/announce texto | Anúncio destacado no chat | moderador |
/shoutout canal | Enviar shoutout para outro canal | moderador |
/ban login motivo | Ban permanente | moderador |
/timeout login 600 motivo | Timeout em segundos | moderador |
/unban login | Remover ban ou timeout | moderador |
/clear | Limpar o chat | moderador |
/slow 10 | Modo lento, em segundos | moderador |
/followers 30m | Somente seguidores | moderador |
/subscribers / /emoteonly | Restringir o chat | moderador |
/raid canal | Iniciar raid | dono ou permissão da Twitch |
/unraid | Cancelar raid pendente | dono ou permissão da Twitch |
/marker texto | Criar marcador no VOD | dono ou editor |
/commercial 60 | Rodar comercial | afiliado/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.