Create bot and Communications Orchestrator project
  • 11 Jun 2024
  • 3 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

Create bot and Communications Orchestrator project

  • Dark
    Light
  • PDF

Article summary

A bot in Corezoid represents a separate project, which is created from scratch following a simple procedure:

You can connect Communications Orchestrator to new or earlier created messenger bots.

Step 1. Create bots in messengers

Communications Orchestrator accesses bots in the messengers using HTTP API with token identification. A token is a key for accessing your bot. Anyone who possesses this key can control your bot. The token storage and access to it must comply with security requirements for sensitive data.

To connect an existing bot to Communications Orchestrator, go to step 2. Connect bots to Communications Orchestrator in Corezoid.

Telegram

  1. Begin a chat with BotFather and click Start.
  2. Send the /newbot command to BotFather to create a new bot.
  3. Follow the BotFather’s instructions:
    • Name your bot.
    • Give your bot a username to be displayed in contacts, chats, and addresses.
      Note: A username must have the bot ending, for example, TetrisBot or tetris_bot. The name and username of a bot must be unique in Telegram.
  4. Save the provided access token to your bot.

Viber

Follow the contact form link to submit your application for a Viber bot registration. Our Support team will guide you through the procedure and provide all the necessary information.

Facebook Messenger

  1. Log in to your Facebook account.

  2. Create a new page that your bot will be connected to by following the instructions.
    Note: You must connect each Facebook bot to a Facebook page.

  3. Go to Facebook for Developers.
    Note: If you are new here, register as a developer.

  4. Hover over My Apps, and then click Create New App.

  5. In the Create a New App ID dialog, fill in all the fields and click Create App ID.
    Create New App ID dialog

  6. Click the app creation icon.
    Creating app icon

  7. On the left navigation panel, click Dashboard, and in the Add a Product list, find Messenger and click Set Up below.
    Add a Product

  8. In the Page dropdown list of Access Tokens on the Messenger Settings page, select Edit Permission.
    Note: This is the page you created in step 2.
    Edit permissions

  9. In the new browser dialog, click Continue as [Your Profile Name] to confirm assigning your bot to your Facebook account.
    Continue as profile name

  10. In the next dialog, select the checkbox of the page your bot will be attached to and click Next.
    Note: This is the page you created in step 2.
    Pages to bot

  11. In the next dialog, set the toggle for your page to YES to allow your bot to participate in the P2P chats in the messenger and click Done.
    Toggle Yes

  12. In the next dialog, click Ok.
    Liinked to_Yes

  13. In the Page Access Token field, copy and save the access token.
    Copy Token

Step 2. Connect bots to Communications Orchestrator in Corezoid

  1. Go to admin.corezoid.com, open the Workspace tab, and click the Projects folder.

  2. Select the needed stage, create a new project, or open an existing one.
    Note: To create a Communications Orchestrator project, choose a non-immutable stage.

  3. In the upper-left corner, click Create and from the dropdown list, select Orchestrator.
    Create Orchestr

  4. In the Communications Orchestrator dialog:

    1. Select the messengers you want to integrate.
    2. Paste the access token you copied when creating the bot
    3. Click Next.

    Com Orch dialog_2

Note:

  • If the connecting process didn’t succeed, check each token to be valid.
  • If you connect Facebook Messenger, you need to subscribe to Facebook Webhooks in the Facebook admin panel. For more information, go to Subscribe to Facebook Webhook.
  1. In the dialog, click Open the created Bot to open the Communications Orchestrator folder.

The bot is connected to the Communications Orchestrator folder, and you can start working in the folder. For more information, go to Components.

Comm Or folder

Subscribe to Facebook Webhook

When you select other messengers, these steps are done automatically.

  1. Go to your Facebook app’s page for developers.

  2. Copy your access token created above Facebook Messenger, step 14).

  3. In the Communications Orchestrator dialog of Corezoid, click Copy under the Webhook URL for Facebook Messenger.
    Copy URL

  4. In the left navigation panel, go to Messenger > Settings and click Subscribe to Events.
    Subscribe to events

  5. In the New Page Subscription dialog:

    1. Enter the copied Webhook URL in the Callback URL field.
    2. Enter the copied token in the Verify Token field.
    3. Select the messages, messaging_postbacks, and messaging_optins checkboxes.
    4. Click Verify and Save.

    Verify token

  6. In the Select a Page dropdown list of the Webhooks page, select the page to which your page will be subscribed for events and click Subscribe.
    Select page

You’ve created your first Communications Orchestrator.


Was this article helpful?