NEW: Regional Recruiter setting

[[violet]]

Hello! Regions can now restrict who can send recruitment telegrams on their behalf, if they wish. Founders and Delegates with executive power will find a new setting in Region Control -> Communication.

This was a feature request from the Land of Kings and Emperors.

[Luxdonia]

I just noticed this with Archmont Founder and I must say, this is a pretty awesome feature.

Thanks admins!

[Kaboomlandia]

Noticed this with a puppet of mine, seems pretty cool.

Thanks!

[United Western States of America]

Awesome! Thank y'all very much, this is going to be SO helpful!

[Ancient and Noble House of Ravenclaw]

Thank you muchly!

[Misley]

Any chance this setting could be displayed to users on the Regional Administration page? As it stands, with no entry in Regional Happenings and no indication anywhere else, it's impossible for members of regions to know what their recruitment policy is.

[Cresenthia]

Any chance this setting could be displayed to users on the Regional Administration page? As it stands, with no entry in Regional Happenings and no indication anywhere else, it's impossible for members of regions to know what their recruitment policy is.

Well, you could start by trying to recruit yourself to your own region.

What does the API only option do?

[Xanama]

Good(?)

[Misley]

Any chance this setting could be displayed to users on the Regional Administration page? As it stands, with no entry in Regional Happenings and no indication anywhere else, it's impossible for members of regions to know what their recruitment policy is.

Well, you could start by trying to recruit yourself to your own region.

How is this a reasonable solution to a problem that could easily be fixed by a line of code adding this setting to the page that already displays all the other settings used by a region?

What does the API only option do?

Disables manual recruitment telegrams and forces recruitment to go through the Telegram API, presumably. As the Telegram API can't be circumvented (to my knowledge - but I'm not going to poke around at it to look for any weaknesses), it would prevent cases like LKE's ("manual" recruitment that breaks the rules by a player causing punitive action against the region, which in LKE's case consisted of a total recruitment ban that I think is still in effect) from occurring again.

[[violet]]

Any chance this setting could be displayed to users on the Regional Administration page?

Good idea! Added.

[Onderkelkia]

We are most grateful that this feature has been implemented so promptly.

Once the present recruitment block concludes, the LKE will opt for API-only recruitment. This step will place control of recruitment entirely in trusted hands and is intended to eliminate the risk of any future unforeseeable incidents involving a manual recruiter behaving in a manner contrary to site rules.

However, apart from addressing our specific concerns, this feature should be of general help to regions in controlling recruitment done in their name.

[Christian Democrats]

Is it possible that you could add to this feature in the future, maybe allowing founders and delegates to block and permit specific nations to recruit?

(question prompted by an actual problem)

[United Western States of America]

Is it possible that you could add to this feature in the future, maybe allowing founders and delegates to block and permit specific nations to recruit?

(question prompted by an actual problem)

Also on this train on thought, is it possible to specify exactly who may end up receiving these telegrams (e.g. New 100, Refounded 2500, etc.), or would this throw the telegram balancing out of whack?

[Mousebumples]

Is it possible that you could add to this feature in the future, maybe allowing founders and delegates to block and permit specific nations to recruit?

(question prompted by an actual problem)

That's something that was considered and may be implemented in the future. However, the coding of such an addition is much more intricate than what has currently been implemented.

So while it's possible, I don't know that it's likely - especially in the near future.

[Christian Democrats]

The problem, for the record, is a region member who dislikes the official recruitment message, so he started sending his own "better" recruitment telegrams (with grammatical errors). I'm trying to reason with him right now, but I've switched the recruiter setting to API only in the meantime to stop him. I would prefer to have an option to appoint recruitment officers because there is another region member who is willing to send out manual telegrams for a short time each day (using the official message) in addition to the script that we have running.

Another option, which I've recommended in the past, is letting nations share the same telegram template. That way, the founder or delegate could set a single Recruitment Telegram for the region, like the Welcome Telegram, with region members only being able to send that one official message. I was told, unfortunately, that this would require some major changes to the current TG system.

[[violet]]

Thanks, it's always handy to hear of real-life examples.

Regions can now specify which nations are permitted to send recruitment telegrams for the region, using the same setting.

[Christian Democrats]

Thanks, it's always handy to hear of real-life examples.

Regions can now specify which nations are permitted to send recruitment telegrams for the region, using the same setting.

Thank you. This addition helps a lot.

[The Blaatschapen]

Thanks, it's always handy to hear of real-life examples.

Regions can now specify which nations are permitted to send recruitment telegrams for the region, using the same setting.

Can this be considered to be the first 'regional officer'?

[United Western States of America]

So, I've been trying to send an API recruitment campaign, but it's not working. If I want to use API recruitment, do I need to have the "API only" option selected, or is it supposed to work with all of the options? I authorized this account for recruitment, so by my logic the campaign should be running, but for whatever reason it isn't.

I think that its either that or I goofed up with the API.

[[violet]]

If I want to use API recruitment, do I need to have the "API only" option selected

No. You only do that if you want to block everything but the API.

for whatever reason

The API returns error codes to describe the cause of any failure, e.g. status "403 Client Not Registered for API".

[United Western States of America]

If I want to use API recruitment, do I need to have the "API only" option selected

No. You only do that if you want to block everything but the API.

for whatever reason

The API returns error codes to describe the cause of any failure, e.g. status "403 Client Not Registered for API".

Ah, thank you for explaining. And just on cue, I have three people yelling at me for the API campaign, so I know its working. Thanks.

EDIT: Perhaps it would also be worthwhile to also set up some kind of "recruitment office" like the one used by NS++. That way, recruiters can also view what campaigns are active and what campaigns have been retired.

[Ever-Wandering Souls]

Inquiry-

If the setting is set to "Specified nations only" and Nation A is a specified nation, and holder of an API client key...

while Nation B is not specified, but has sent a tag:api tg and shared the TGID and secret key with nation A

and nation A then goes to send that recruitment telegram via API...

Will it go through?

-Understanding that Nation B would not be able to send a Tag:api tg marked as recruitment while that setting is in place
-Assuming that Nation B obtained those codes prior to the setting being restricted as so not to allow them to send recruitment messages.

Thank you!

[Ever-Wandering Souls]

*two and a half day bump*

[[violet]]

If the setting is set to "Specified nations only" and Nation A is a specified nation, and holder of an API client key...

while Nation B is not specified, but has sent a tag:api tg and shared the TGID and secret key with nation A

and nation A then goes to send that recruitment telegram via API...

Will it go through?

No. The API doesn't care which nation applied for the API key; it only cares whether the key is valid for this region. So here it will see a request with a valid client key to send a telegram authored by Nation B, who is not authorized to recruit. This will fail.

[Ever-Wandering Souls]

Thank you!