Anúncios da VTC

Os Anúncios da VTC permitem à tua equipa publicar atualizações automáticas no Discord sempre que algo importante acontece na tua VTC. Exemplos incluem um membro a entrar, uma candidatura a ser submetida, ou um evento a ser cancelado.

As mensagens são enviadas através de webhooks do Discord que crias no teu próprio servidor. Escolhes que eventos anunciar e o aspeto de cada mensagem.

Requisitos

O módulo Anúncios da VTC tem de estar ativado para a tua VTC na TrucklineMP.
Precisas de um servidor de Discord onde possas criar webhooks (Definições do Servidor → Integrações → Webhooks).
A equipa que configura anúncios precisa das permissões de VTC corretas (ver Permissões abaixo).

Aceder aos Anúncios

Abre o perfil da tua VTC e vai a Gerir.
Seleciona Anúncios na barra lateral de gestão (sob Membros).
Adiciona um webhook e depois ativa os eventos que te interessam.

Podes adicionar até 10 webhooks por VTC. Usa vários webhooks quando quiseres canais diferentes para tópicos diferentes (por exemplo, um para recrutamento e outro para eventos).

Configurar um Webhook

Criar um webhook do Discord

No Discord, abre o canal pretendido.
Vai a Editar Canal → Integrações → Webhooks → Novo Webhook.
Copia o URL do webhook. Tem o formato https://discord.com/api/webhooks/....

Adicioná-lo na TrucklineMP

Na página de Anúncios, clica em Adicionar webhook.
Dá-lhe um nome claro (por exemplo, Registo da equipa ou Alertas de recrutamento).
Cola o URL do webhook do Discord e guarda.

Os URLs de webhook são guardados de forma segura. Após a criação, só é mostrada uma versão mascarada do URL na lista.

Permissões

Atribui estas permissões através de Cargos e Permissões da VTC:

Permissão	Objetivo
`announcements.manage`	Criar, editar e eliminar webhooks; alterar modelos de eventos; exportar configuração
`announcements.view`	Ver webhooks e o registo de entregas
`announcements.test`	Enviar mensagens de teste sem acesso total de gestão

Dá manage à liderança ou a cargos de RH. Dá view à equipa que só precisa de confirmar que as mensagens estão a ser entregues. Test é útil para equipa em período experimental que precisa de verificar a configuração sem alterar a configuração de produção.

Configurar Eventos

Cada webhook tem a sua própria lista de eventos. Expande um grupo (Membros, Recrutamento, Eventos, etc.) e depois ativa ou desativa eventos individuais.

Modelos por defeito

A maioria dos eventos vem com um embed do Discord por defeito sensato. Deixa Usar modelo de mensagem por defeito ativado, a menos que queiras controlo total.

Modelos personalizados

Desativa o modelo por defeito para editar:

Conteúdo da mensagem (texto simples opcional acima do embed)
Título, descrição, URL, cor e rodapé do embed
Substituições de nome de utilizador e avatar do webhook apenas para esse evento

Usa variáveis (listadas na barra lateral do separador de configuração) para inserir dados em tempo real. Exemplo: **{member.name}** joined {vtc.name}.

Ações em massa

Tudo ligado / Tudo desligado no cabeçalho de cada grupo alterna todos os eventos desse grupo.
Os predefinidos Minimal, Detailed staff log e Public-friendly aplicam uma configuração inicial. Detailed ativa todos os eventos; Public-friendly ativa um conjunto mais reduzido voltado para os membros.

Menção de cargo (opcional)

Por evento, podes definir um ID de cargo a mencionar (snowflake de cargo do Discord). Quando o evento dispara, a mensagem incluirá <@&roleId> para que esse cargo seja notificado.

Entrega condicional (opcional)

Por evento, podes adicionar condições:

Horas silenciosas com fuso horário, hora de início e hora de fim (os anúncios são ignorados nesse período).
Apenas com recrutamento aberto (dispara apenas quando o recrutamento está aberto na tua VTC).
Requer cargo (dispara apenas quando o membro afetado tem um cargo específico da VTC).

Variáveis de Modelo

As variáveis são substituídas quando a mensagem é enviada. As mais comuns:

Variável	Significado
`{vtc.name}`	Nome de exibição da VTC
`{vtc.handle}`	Handle da VTC (com @)
`{vtc.url}`	URL público do perfil da VTC
`{member.name}`	Nome do membro afetado
`{actor.name}`	Membro da equipa que realizou a ação
`{role.name}`	Nome do cargo
`{application.id}`	ID da candidatura de recrutamento
`{news.title}`	Título da publicação de notícias
`{event.name}`	Nome do evento
`{event.url}`	URL da página do evento
`{reason}`	Texto de motivo ou nota
`{timestamp}`	Hora UTC do evento

A interface lista todas as variáveis suportadas. Clica numa para a copiar para o teu modelo.

Eventos Suportados

Os eventos estão agrupados na interface de gestão. Todos estão desativados por defeito, exceto membro entrou, membro saiu e membro expulso em novos webhooks.

Membros

Membro entrou
Membro saiu
Membro expulso
Cargo atribuído a membro
Cargo removido de membro

Recrutamento

Candidatura submetida
Candidatura aceite
Candidatura rejeitada
Candidatura retirada

Convites

Convite criado
Convite resgatado
Convite revogado

Notícias

Notícia publicada
Notícia atualizada
Notícia eliminada

Eventos

Evento criado
Evento atualizado
Evento cancelado
Difusão de evento (mensagem da equipa para participantes)
Alteração de RSVP
Check-in do evento
Participante aprovado (quando é necessária aprovação)
Evento auto-cancelado (sem inscrições antes do início)
Vaga de depósito solicitada
Vaga de depósito decidida (aprovada ou rejeitada)

Cargos

Cargo criado
Cargo atualizado
Cargo eliminado

Gestão

Propriedade transferida
Entrada de lista negra adicionada
Entrada de lista negra removida
Definições atualizadas
Recrutamento alternado (aberto ou fechado)
VTC dissolvida
Servidor de Discord desligado da VTC

Verificação

Candidatura de verificação submetida
Verificação aprovada
Verificação rejeitada

Modos de Entrega

Instantâneo (por defeito)

Cada evento ativado é enviado para o Discord assim que ocorre. As entregas falhadas são repetidas automaticamente (até três tentativas com espera progressiva).

Resumo diário

Quando o resumo diário está ativado num webhook, os eventos são colocados em fila e combinados numa única publicação de resumo diário, em vez de serem enviados imediatamente. Útil para VTCs com muita atividade que ainda assim querem um canal de equipa sem notificações constantes.

Espelho na App (opcional)

Podes ativar espelhar na app num webhook. Quando um anúncio dispara, a equipa com announcements.view recebe também uma notificação dentro da aplicação na TrucklineMP. Isto não substitui o Discord; dá à equipa um canal de reserva dentro do site.

Testar, Exportar e Duplicar

Enviar teste escolhe um evento de exemplo e publica uma mensagem de pré-visualização no Discord. Existe um curto período de espera entre testes.
Duplicar copia a configuração de eventos de um webhook para um novo webhook (desativado por defeito até ativares).
Exportar descarrega a tua configuração de modelos em JSON para cópia de segurança ou para copiar para outra VTC.

Executa sempre um teste depois de alterar modelos ou URLs de webhook.

Registo de Entregas

Abre o separador Registo de entregas para veres os envios recentes do webhook selecionado.

Filtra por sucesso ou falha, ou por identificador de evento.
As linhas falhadas mostram o estado HTTP e o texto de erro devolvido pelo Discord.
Usa Reenviar numa linha falhada para colocar em fila uma nova tentativa de entrega.

Se um webhook falhar repetidamente, pode ser desativado automaticamente para proteger o teu canal de URLs quebrados. Reativa-o nas definições do webhook depois de corrigir o URL do Discord. Aparece um aviso quando isto acontece.

Opções ao Nível do Webhook

Além das definições por evento, cada webhook suporta:

Nome de utilizador por defeito e avatar por defeito (usados quando um modelo de evento não os substitui)
Interruptor de Ativado / desativado para o webhook inteiro
Modo de entrega (instantâneo ou resumo diário)

Dicas e Boas Práticas

Usa canais separados para audiências separadas. Um canal público #anuncios pode só precisar de membro entrou e notícia publicada. Um canal privado #registo-equipa pode usar o predefinido Detailed.

Começa pequeno. Ativa alguns eventos, testa-os e depois expande. Ativar tudo de uma vez torna difícil identificar modelos mal configurados.

Mantém os URLs de webhook em segredo. Qualquer pessoa com o URL pode publicar no teu canal. Se um URL vazar, elimina o webhook no Discord, cria um novo e atualiza a TrucklineMP.

Faz corresponder permissões à responsabilidade. Nem todos os oficiais precisam de announcements.manage. As permissões view e test são suficientes para muitos cargos.

Verifica o registo de entregas após alterações. Se o Discord devolver 404, o webhook foi eliminado do lado do Discord. Cria um novo webhook e cola o novo URL.

Resolução de Problemas

Nenhuma mensagem aparece no Discord

Confirma que o webhook está ativado e que o evento específico está ativado.
Verifica o Registo de entregas para falhas.
Verifica se o webhook do Discord ainda existe nas Definições do Servidor.
Confirma que o módulo Anúncios da VTC está ativado para a tua VTC.

As mensagens pararam depois de terem funcionado

O webhook pode ter sido desativado automaticamente após falhas repetidas. Corrige o URL e reativa.
O Discord pode ter removido o webhook. Cria um novo.

O teste funciona mas os eventos reais não

O evento pode estar desativado, ou uma condição (horas silenciosas, recrutamento aberto, cargo obrigatório) pode estar a bloqueá-lo.
O modo de resumo diário coloca as mensagens em fila até o resumo ser executado.

Nomes errados ou detalhes em falta na mensagem

Verifica as tuas variáveis de modelo. Um erro como {member.name} em vez de {target.name} altera quem é mostrado.
Modelos personalizados que omitem variáveis continuam a funcionar, mas o texto estático não incluirá dados dinâmicos.

Guias Relacionados

Cargos e Permissões da VTC: atribuir permissões de anúncios a cargos
Gestão de Membros da VTC: ações que disparam eventos de membros
Recrutamento da VTC: eventos de candidaturas e alternância de recrutamento
Verificação de Discord da VTC: separado dos anúncios; liga o teu servidor para exibição no perfil
Definições Gerais: identidade da VTC e definições de recrutamento