A capacidade de saudação recebe as pessoas num canal. Uma boas-vindas tem duas metades com públicos diferentes: uma linha curta que a sala inteira lê, e as linhas privadas que orientam quem chegou sem mais ninguém ver.
As duas metades
| Definição | Quem lê | Quando |
|---|---|---|
public_greeting |
Toda a gente no canal | Só na primeira vez que este bot encontra esta alcunha aqui |
greeting |
Só quem chegou | A cada entrada que a janela de repetição permitir |
onboarding_1 … onboarding_4
|
Só quem chegou | A cada entrada que a janela de repetição permitir |
visitor_greeting |
O visitante sozinho | Cada vez que o visitante abre o canal |
farewell |
Depende de farewell_delivery | Ao sair |
Como definir
/bot set <name> public_greeting <text>\n/bot set <name> greeting <text>\n/bot set <name> onboarding_1 <text>\n/bot set <name> onboarding_2 <text>\n/bot set <name> greeting_delivery private_notice\n/bot set <name> onboarding_delivery private_notice\n/bot set <name> greeter_repeat_window 43200\n/bot set <name> farewell none
Qualquer uma delas aceita none para apagar. Uma linha apagada é saltada, portanto um bot só com saudação comporta-se exatamente como sempre. As linhas de boas-vindas são numeradas em vez de acumuladas: definir onboarding_2 duas vezes substitui, e é isso que permite colar um script de aprovisionamento mais de uma vez.
Como um bot cumprimenta os visitantes
Um visitante sem conta pode ler um canal. Eles não podem se juntar ou digitar. Um visitante não recebe greeting ou onboarding_1 … onboarding_4. Nada é dito no canal quando um visitante chega. Defina visitor_greeting para recebê-los. Só o visitante o vê. Ele é enviado cada vez que eles abrem o canal. Nenhum bot cumprimenta visitantes até que esteja definido.
/bot set <name> visitor_greeting <text>
Entrega
| Modo | Efeito |
|---|---|
public |
Uma mensagem no canal. Fica no histórico. |
channel_notice |
Um aviso no canal. Fica no histórico. |
private_notice |
Um aviso que só quem chegou vê, na vista daquele canal. Não fica no histórico. |
silent |
Nada é enviado. |
greeting_delivery cobre a saudação; onboarding_delivery cobre as linhas numeradas e recai em greeting_delivery quando não está definido. public_greeting é sempre pública — é para isso que existe.
Quem conta como novo
O bot regista quem já recebeu em cada canal, e esse registo sobrevive a um reinício. Quem ele nunca encontrou recebe a linha pública e as privadas. Quem ele encontrou há mais de greeter_repeat_window segundos recebe as privadas de novo, mas a sala não é avisada duas vezes. Quem acabou de estar aqui não recebe nada.
Uma janela de repetição de 0 significa que não há janela: as linhas privadas saem a cada entrada. A linha pública continua a sair uma vez por pessoa, para sempre.
Marcadores
Toda a linha aceita {nickname} para quem entrou, {channel} para a sala, {botname} para o bot e {prefix} para o prefixo de comando dele. As linhas também aceitam os escapes de formatação IRC: \c04 vermelho, \b negrito, \o reset.
Manter a sala legível
Só um bot por canal deve saudar. Dois saudadores recebem cada novato duas vezes, e é por isso que um bot que fica em todas as salas tem greeting none. Mantenha a linha pública numa frase: é a única parte das boas-vindas que a sala inteira lê e a única que persiste. Tudo o que quem chega precisa de aprender pertence à metade privada.