Resources »

Guides »

Integrations »

Twitter »

Cerb + Twitter

Introduction

In this guide we’ll walk through the process of linking Cerb to Twitter. You’ll be able to use Twitter’s full API from bots in Cerb to automate whatever you need.

Create an OAuth application at Twitter

Next, you need to create a new OAuth app on Twitter for Cerb to connect to. Review the Twitter Developer Documentation additionally if needed.

  1. Visit the Twitter Create an application developer page.

  2. Enter the following details replacing the highlighted blocks with your info:
    • Name: Cerb for Your Company Name
    • Description: Connects your Twitter account with Cerb Helpdesk
    • Website: https://example.cerb.me
    • Callback URL: https://YOUR-CERB-HOST/oauth/callback
  3. Click the Create your Twitter application button.

  4. Make a note for the next step of your Consumer Key and Consumer Secret which can be found in the Keys and Access Tokens tab on the following page.

Create the Twitter service in Cerb

  1. Navigate to Setup » Configure » Import Package.

  2. Paste the following package:

     
    	
     {
       "package": {
         "name": "Twitter Connected Service",
         "revision": 1,
         "requires": {
           "cerb_version": "9.1.0",
           "plugins": []
         },
         "configure": {
           "placeholders": [],
           "prompts": [
             {
               "type": "text",
               "label": "Client ID",
               "key": "prompt_client_id",
               "params": {
                 "default": "",
                 "placeholder": "(paste your Client ID)"
               }
             },
             {
               "type": "text",
               "label": "Client Secret",
               "key": "prompt_client_secret",
               "params": {
                 "default": "",
                 "placeholder": "(paste your Client Secret)"
               }
             }
           ]
         }
       },
       "records": [
         {
           "uid": "service_twitter",
           "_context": "connected_service",
           "name": "Twitter",
           "extension_id": "cerb.service.provider.oauth1",
           "params": {
             "grant_type": "authorization_code",
             "client_id": "{{{prompt_client_id}}}",
             "client_secret": "{{{prompt_client_secret}}}",
             "request_token_url": "https://api.twitter.com/oauth/request_token",
             "authentication_url": "https://api.twitter.com/oauth/authenticate",
             "access_token_url": "https://api.twitter.com/oauth/access_token",
             "signature_method_": "HMAC-SHA1"
           }
         },
         {
           "uid": "account_twitter",
           "_context": "connected_account",
           "name": "Twitter",
           "service_id": "{{{uid.service_twitter}}}",
           "owner__context": "cerberusweb.contexts.app",
           "owner_id": "0",
           "params": {}
         }
       ]
     }
    	
     
     
  3. Click the Import button.

  4. Enter your client ID and secret from Twitter.

  5. Click the Import button again.

Link the connected account to Twitter in Cerb

  1. Click on the Twitter bubble in the Connected Accounts section after importing the above package.

  2. Click on the Edit button in the card popup.

  3. Click the blue Link to Twitter button.

  4. Accept consent on Twitter.

  5. Click the Save Changes button.

Use the connected account in bot behaviors

You can use the connected account you just created to access Twitter’s API from bot behaviors in Cerb. This is typically accomplished using the Execute HTTP Request action from a bot, and selecting the connected account in the Authentication: section.

You can import the Twitter Bot package for a working example.