A capacidade de saudação recebe as pessoas num canal. Uma boa-vinda 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
| Ajuste | Quem lê | Quando |
|---|---|---|
public_greeting |
Todo mundo no canal | Só na primeira vez que este bot encontra este apelido 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 é pulada, então um bot só com saudação se comporta exatamente como sempre. As linhas de boas-vindas são numeradas em vez de acumuladas: definir onboarding_2 duas vezes substitui, e é isso que deixa colar um script de provisionamento 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 visão 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 ela existe.
Quem conta como novo
O bot registra quem ele já recebeu em cada canal, e esse registro 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 saindo uma vez por pessoa, para sempre.
Marcadores
Toda 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 em uma frase: é a única parte da boa-vinda que a sala inteira lê e a única que persiste. Tudo o que quem chega precisa aprender pertence à metade privada.