Social Planner: setup

This section describes in sufficient detail the process of configuring providers for sending messages. Read the instructions carefully and check the screenshots. Use the icons below to quickly navigate through the guides of various social networks.

Getting social networks Authentication tokens can be a little tricky. Please note that the plugin cannot affect this.

Telegram

You can send messages to any group or channel. To do this, you need to create and add a special Bot to the required chat with the ability to send messages.

Write to the @BotFather in Telegram and create a new Bot. Follow the bot prompts, fill in all required fields and get an API Token.

Then you need to find out the group or channel ID. If the chat has a public link, then you can use its username (in the format @channelusername).
Otherwise you can write the message to @username_to_id_bot or use this guide. Note that chat ID can be negative.

Social Planner Telegram configuration
Example settings for Telegram.

If you have an access error when sending a message, try to check the correctness of the API Token and the chat ID, bypassing the plugin.

You can find full help on Telegram Bot API on the official website.

Facebook

With this plugin you can publish to Facebook Pages only. If you already have an application with permissions to publish to your page, you can immediately proceed to the stage of obtaining the Page ID.

Attention! Due to Facebook Restriction we can use the new Facebook App in HTTPS sites only.

Attention! You can publish to Facebook with the approved app only. So you need to submit the app for approval and it may take upto 3 months to get the approval. Facebook changes the rules of using its products often, so before starting the setup, read the latest guidelines on the help page.

To create a new Facebook application, go to the developer pages and create new one. You will need to select the type of your application.

Social Planner Facebook configuration
The easiest way to focus on Business integrations.

Enter the App Display Name and the contact Email. The purpose is for Yourself or your own business.

After the application is created, let's find out the ID of your page. Read how to do it on the Facebook help page.

Social Planner Facebook configuration
This is how the Page ID usually looks.

Now let's move on getting access token. For this you can use Graph API Explorer tool. In the right section select your Facebook App and in the User or Page field click Get page access token.

Now you need to request some required permissions:

Social Planner Facebook configuration
Ideally you should see something like this for your app and page.

Check that the access token is working by sending a POST request in the Graph Explorer tool of the {PageID}/feed. Error The post is empty. Please enter a message to share means that the token is correct. If the error says about the need to obtain additional permissions, then you will have to pass the application verification. You can read more about this in the Facebook help guide.

The received token must be made long-term with Access Token Debuger. You can also get a permanent token using this guide.

Social Planner Facebook configuration
Receiving permanent token in Access Token Debugger.

After receiving the access token and Page ID, you can proceed to configuring the plugin.

Social Planner Facebook configuration
Example settings for Facebook.

VK.com

You can send messages both to your profile wall and to the community where you are an administrator.

Start by registering your app on the developer page. Enter something in the title field and choose Standalone app platform. Then confirm your action with phone call or push notification.

Social Planner VK.com configuration

Go to the Settings tab and copy the App ID. Insert this ID to the field below and push the button to generate your Token.

After you agree to the terms and conditions, the page will be redirected to oauth.vk.com domain. Your Token will be in access_token parameter.

Social Planner VK.com configuration

Please note that VK.com warns you not to transfer the Token to other sites. So keep it secret and only use it on trusted sites. Social Planner does not send any user data to remote servers.

Now you need to get the profile or community ID. You can find it in the links of your pages. Use a negative value to designate a community ID.

Social Planner VK.com configuration
You can see the ID in the url on the stats page for example.

Use access token and group ID on the plugin settings page.

Social Planner VK.com configuration
Example settings for VK.com.

Twitter

To set up this provider, you need to have full access to your Twitter account, as well as access to the attached Email in order to receive messages from support. If you already have a developer account and you created the application earlier, then skip directly to the last step.

Attention! Getting keys on Twitter can take patience and time. It is plugin independent and completely on your shoulders.

Log in to Twitter Developers and click on the Apply for a developer account button.

Now you need to fill out a form to obtain developer status. Fill in all fields and submit. You will receive a response in about 12 hours. Try to describe in as much detail how you will use the keys and on which specific site. A sample description is given below.

I am using a WordPress plugin Social Planner (https://wordpress.org/plugins/social-planner/) to publish posts automatically from blog to Twitter. The plugin requires Twitter App to publish posts from WordPress to Twitter. For this I must create an app and provide the app details such as API key, API secret, Access token and Access token secret. While creating a new post on my WordPress site, I can schedule the task to send this post to Twitter with custom excerpt or image. The detailed process is described in the documentation for the plugin (https://wpget.org/social-planner/#task-scheduling).

Social Planner Twitter configuration
Accept terms and conditions and submit the application.

Once the developer account gets approved, you will get a mail from Twitter. Then you can create a new app. In the create app section we can add the App Name, Application description, website url, and tell how the app is used. A sample description is given below.

I am using a WordPress plugin to publish posts automatically from blog to Twitter as a simple text message or or as text message with image. The plugin requires Twitter App to publish posts from WordPress to Twitter. For this I must create an app and provide the app details such as API key, API secret, Access token and Access token secret.

Review the terms and create the app. Go to the Keys and tokens section. Click on the Create button under Access token & access token secret section.

Now you can use the received keys to configure the plugin. Access level should be Read and write.

Social Planner Twitter configuration
Necessary Twitter access tokens.

You need to use all keys and tokens when configuring the plugin. Fields order on the settings page is the same as the order in Twitter.

Social Planner Twitter configuration
Example settings for Twitter.

OK.ru

With this plugin you can publish to OK.ru groups only. If you already have an application with permissions to publish to your group, you can immediately proceed to the configuring the plugin.

Attention! You can publish to OK.ru groups with the approved app only. So you need to submit the app for approval and request the necessary permissions. This process usually takes 3 days, but the time frame may increase.

Log in to OK.ru and go to the develpment page for creating a new application.

Fill in the settings fields. Select the type-custom application and save it. Immediately after that, a letter should come to your mail indicating your application credentials.

Social Planner OK.ru configuration
Do not forget to fill in all the required fields and save the application settings.

Now you need to request additional permissions for your app in order to be able to post. To do this, send an email to api-support@ok.ru with the ID of your application and a detailed description of the tasks for which you need permissions. A sample description is given below. Do not forget to replace values in brackets.

Здравствуйте, прошу предоставить разрешения на создание топиков в моем сообществе в Одноклассниках [link to your group] для моего приложения с ID [application ID from email]. Публикация будет выполняться с моего сайта [link to your WordPress site] с помощью плагина Social Planner: https://wordpress.org/plugins/social-planner. Требуемые разрешения: GROUP_CONTENT, PHOTO_CONTENT. Для других целей это приложение использоваться не будет.

You will receive an answer in about 3 days. If you have not received the letter, check the application settings, you may have already been granted permissions. You can do this by following the link and selecting the application you need.

Social Planner OK.ru configuration
This is how the screen will look after the OK.ru support team gives you permissions.

New fields GROUP_CONTENT and PHOTO_CONTENT will appear in the access rights of your application. Now you can proceed to configuring the plugin. First of all, get an access token. Copy both access token and secret session key to the plugin settings.

You can find the Application public key at the top of your app's settings page or in the first letter from OK.ru support team. The Group ID value can be viewed in the link address of your group or on its settings page.

Social Planner OK.ru configuration
Example settings for OK.ru.
Back to Social Planner summary