DMs do Sistema

Uma transmissão de DM do sistema entrega uma mensagem idêntica, de autoria da conta do sistema, a cada destinatário fornecido. Um destinatário recebe uma mensagem normal em um canal de mensagem direta normal.

O recurso Jobs relata o progresso da entrega. Cancelar esse job interrompe uma transmissão em andamento.

Criar transmissão de DM do sistema

POST/v1/admin/system-dmsAudit reason

Enfileira uma mensagem para entrega a cada destinatário fornecido. Requer system_dm:send. Retorna o número de destinatários enfileirados.

Corpo JSON

Campo	Tipo	Descrição
content1	string	A mensagem entregue a cada destinatário (1-4000 caracteres)
user_ids2	array[snowflake]	Os destinatários da transmissão (1-10.000 entradas)

¹ Conteúdo sem caractere visível é aceito e então falha para cada destinatário

² O Decoding Chat mantém os IDs duplicados, então um destinatário repetido recebe a mensagem uma vez por ocorrência. Um ID que não nomeia nenhuma conta é aceito aqui e ignorado no momento da entrega

Corpo da resposta

Campo	Tipo	Descrição
recipient_count	integer	O número de entradas na matriz user_ids enviada

Resposta

Status	Corpo	Condição
200	corpo da resposta	O job de entrega foi enfileirado
500	resposta de erro	A transmissão não pôde ser agendada

O job continua após um destinatário com falha

Entregas com falha não interrompem os destinatários restantes. Uma execução concluída relata succeeded mesmo quando algumas entregas falharam.

A resposta não tem ID do job

Filtre Listar jobs pelo tipo de tarefa sendSystemDm para encontrar o trabalho enfileirado. O job é enfileirado sem solicitante e sem motivo, portanto, seus requested_by_user_id e audit_log_reason são ambos nulos.

Efeitos colaterais

Para cada destinatário, o job abre o canal de mensagem direta entre a conta do sistema e esse destinatário, e então envia a mensagem. O evento Channel Create chega a um destinatário apenas quando o canal é recém-criado ou foi fechado do lado desse destinatário. Um destinatário que já tem o canal aberto observa apenas Message Create.

Os destinatários não precisam ter interagido com a conta do sistema antes. O Decoding Chat pula as verificações de permissão de mensagem direta para a conta do sistema. Um bloqueio, nenhuma amizade, nenhum servidor (guild) mútuo e as configurações de privacidade de mensagem direta do destinatário não impedem a entrega.

O cancelamento interrompe as entregas restantes e deixa as mensagens enviadas no lugar. O job então relata cancelled.

A operação registra uma entrada de auditoria de Admin com a ação system_dm.send, o tipo de destino system_dm e o ID de destino 0. Seus metadados têm recipient_count e content_length como strings decimais, e o conteúdo em si não é registrado.

Limite de taxa

100 solicitações por minuto para cada usuário autenticado, no bucket admin:message:operation.