Connecting a VK Channel
VK is the leading social network in Russia. Contacts message your VK community, and can send photos, stickers, voice messages, documents and locations or reply by tapping buttons.
Before you start
You'll need a VK community with messages turned on, along with:
- An access key for the community that's allowed to manage its messages.
- Its confirmation string, which VK shows in the community's Callback API settings, under Manage > Working with API > Callback API.
- The community's name and ID.
VK's guide to community messages explains how communities message people.
Adding the channel
Go to Settings > Channels and click New Channel. VK is under Social & Chat, or you can type its name in the search box.
Then fill in the form:
| Field | What to enter |
|---|---|
| Community Access Key | Your community's access key |
| Community Name | Your community's exact name |
| Community ID | Your community's ID, which is a number |
| Confirmation String | The confirmation string from its Callback API server settings |
Click Add Channel.
Finishing setup
Once the channel is added, its configuration page shows a webhook URL and a verify token to add to your community's Callback API settings, under Manage > Working with API > Callback API, so that messages reach your workspace:
- Enter the webhook URL as the server's address, and the verify token as its Secret key.
- Set the server's API version to 5.103.
- Under the server's event types, check new messages (
message_new).
You can come back to these at any time from the channel's page.
Considerations
Your community can only message people who have allowed it to. Someone who messages your community first has allowed it, with no time limit, unless they later block its messages.
To learn more about channels in general, see Introduction to Channels.