Agadar's Telegrammer (updated August 16th, '20)

[Baconbacon123]

Version 1.5.0 has been released. Check the details in the changelog on the releases page.

If I set it to send to 1 new nation and 1 refounded nation and then turned on run indefinitely, would it continuously alternate sending between new and refounded nations?

[Agadar]

Version 1.5.0 has been released. Check the details in the changelog on the releases page.

If I set it to send to 1 new nation and 1 refounded nation and then turned on run indefinitely, would it continuously alternate sending between new and refounded nations?

Version 1.5 doesn't allow you to enter numbers for new nations and refounded nations: instead, the corresponding filters simply get as much recipients as possible, which in the case of new nations is always the 50 latest and in the case of refounded has in my experience always been between 20-40.

You can approximate alternation by simply selecting those two filters and then running indefinitely.

[Baconbacon123]

Hey, I'm having a Java issue when I use the embassies of region filter.

Any suggestion for how to prevent the error?

[Agadar]

Hey, I'm having a Java issue when I use the embassies of region filter.

(Image)

Any suggestion for how to prevent the error?

Heya, Bacon. The issue you're having is a result of your machine not allocating enough memory for Java applications to handle the massive nations dump file, which is needed for the filter you've selected. A work-around is to use one of the solutions when you Google for 'increase java heap space'. If that fails, then you can try it on a machine with better specs.

[Wings of Amnesty]

Question.
https://gyazo.com/94b3fa3fef385cc4c34407ba0b53eeea

This means that it'll queue them all, and then send them all at once, right? Or how does that work?

[Agadar]

Question.
https://gyazo.com/94b3fa3fef385cc4c34407ba0b53eeea

This means that it'll queue them all, and then send them all at once, right? Or how does that work?

It's queued them all and will then go through them one by one, as NationStates dictates there must be a certain amount of time between each telegram sent via the API.

Specifically, 30 seconds for normal telegrams and 180 seconds for recruitment telegrams.

Note that the 'estimated duration' is an ideal prediction. It will likely be less, seeing as many recipients block telegrams and my telegrammer automatically skips those.

[Jamadlenter]

Hi I just receive my Key , but dont know how to use it can someone guide me on how to do this first time.

[Phydios]

Hi I just receive my Key , but dont know how to use it can someone guide me on how to do this first time.

Before you use this program, make sure you're familiar with the Telegrams API. You should know how to obtain a Client Key, and how to create a telegram template. Once you've obtained a Client Key, a Telegram Id, and a Secret Key, you're ready to start using this program.

If you're looking for a guide on how to obtain the keys and a Telegram Id, check out Ever-Wandering Souls' Simple Guide to Sending Telegrams via API!

[Jamadlenter]

Yes I 've already obtain my client key and everything that's required. How do I use the program.

[Agadar]

Yes I 've already obtain my client key and everything that's required. How do I use the program.

What part of the application are you having trouble with?

[Jamadlenter]

I'm having a problem finding the application and getting stated. If its possible can you guide on the steps on doing it .

[Agadar]

I'm having a problem finding the application and getting stated. If its possible can you guide on the steps on doing it .

How are you not finding the application?

[Agadar]

Version 1.6.0 has been released and is ready for testing! If you find any bugs, please report them.

Link to download: https://github.com/Agadar/NationStates- ... ag/v.1.6.0
Direct download: https://github.com/Agadar/NationStates- ... -1.6.0.jar

Changelog:
- Added new 'options' menu and moved the existing 'run indefinitely' option to it;
- Added an option for refreshing the recipients after every sent telegram (which is for example useful for ensuring your recruitment telegrams are sent to the newest of nations);
- Added an option for hiding recipients that were skipped from the output box;
- Added an option for automatically starting sending telegrams on application launch;
- Added an option for launching the application minimized;
- The 'from region' value can now also be supplied for campaign telegrams (previously you could only supply it for recruitment telegrams);
- Vastly improved the speed and reduced the memory usage of recipient filters that rely on data from the daily dump files.

[Omnum]

Hi there!

Thanks for making this public - I've just set up a recruitment campaign. Will this continue even if I shut java?

[Imperium Anglorum]

Thanks for making this public - I've just set up a recruitment campaign. Will this continue even if I shut java?

No.

[Baconbacon123]

Hi Agadar, I have a question about the way the program creates its telegram queue. If I have the filters: +New World Assembly members, +World Assembly Members; will the program give priority to a nation in the New WA member group, or will it send to every nation in a random order?

If this isn't something the program does already, then it would be a very good addition for a future update.

[Volcanu]

Ooh, could be useful

[Agadar]

Hi Agadar, I have a question about the way the program creates its telegram queue. If I have the filters: +New World Assembly members, +World Assembly Members; will the program give priority to a nation in the New WA member group, or will it send to every nation in a random order?

If this isn't something the program does already, then it would be a very good addition for a future update.

Bacon, currently the program sends the telegrams in seemingly random order. 'Seemingly', because under the hood it is not random, but due to the way the set of recipients is built it might appear so to the user.

I like the idea of introducing an option that allows the user to choose between 'random' and 'in order', though. I invite you to make an issue for it over at the repository (https://github.com/Agadar/NationStates- ... ent/issues).

[Zone 71]

Hey. I'm interested in using this API telegrammer, but I'm completely foreign to running programs through Java or Github, and even moreso with programming in general.

Which files should I download from Github, and how do I open the application through Java?

[Agadar]

Hey. I'm interested in using this API telegrammer, but I'm completely foreign to running programs through Java or Github, and even moreso with programming in general.

Which files should I download from Github, and how do I open the application through Java?

Hello Zone.

You'll first want to make sure you have Java installed. You can download the installer here: https://java.com/nl/download/.

After that, you will be able to run my telegrammer simply by double-clicking the .jar file, which you can download here: https://github.com/Agadar/NationStates- ... -1.6.0.jar.

Let me know how that works out for you.

[Zone 71]

Hey. I'm interested in using this API telegrammer, but I'm completely foreign to running programs through Java or Github, and even moreso with programming in general.

Which files should I download from Github, and how do I open the application through Java?

Hello Zone.

You'll first want to make sure you have Java installed. You can download the installer here: https://java.com/nl/download/.

After that, you will be able to run my telegrammer simply by double-clicking the .jar file, which you can download here: https://github.com/Agadar/NationStates- ... -1.6.0.jar.

Let me know how that works out for you.

I just downloaded the two files. The client opened up successfully, so it's looking good so far. Thank you so much for your help, Agadar. And thank you for this awesome API program.

Update: It looks like the program is working. Again, thank you so much Agadar.

[Agadar]

Hello Zone.

You'll first want to make sure you have Java installed. You can download the installer here: https://java.com/nl/download/.

After that, you will be able to run my telegrammer simply by double-clicking the .jar file, which you can download here: https://github.com/Agadar/NationStates- ... -1.6.0.jar.

Let me know how that works out for you.

I just downloaded the two files. The client opened up successfully, so it's looking good so far. Thank you so much for your help, Agadar. And thank you for this awesome API program.

Update: It looks like the program is working. Again, thank you so much Agadar.

Happy to help.

[Zone 71]

I'm sorry to bother you again, but the program isn't able to send telegrams any more. It worked spectacularly for a couple of days, but now, whenever I try to send a telegram, the error message pops up, "NationStates API returned: '403 Client Not Registered For API'." Is there something wrong with a client key or anything like that?

[Frisbeeteria]

"NationStates API returned: '403 Client Not Registered For API'." Is there something wrong with a client key or anything like that?

Probably. We had some failures in the API key table, and that's the error message you get when your key is missing. Reapply via GHR for your key, please. Include your nation name, region name, and reason for the key.

[Zone 71]

"NationStates API returned: '403 Client Not Registered For API'." Is there something wrong with a client key or anything like that?

Probably. We had some failures in the API key table, and that's the error message you get when your key is missing. Reapply via GHR for your key, please. Include your nation name, region name, and reason for the key.

Thank you.