Help Center

Turn WhatsApp Messages into Pyrus Tasks

If your customers reach out on WhatsApp, you don't have to juggle apps. Just connect the two, and every incoming message will land as a fresh task right in your Pyrus Inbox.

Want to track where your requests are coming from? You can automatically tag them by channel and filter your reports or task lists to see exactly which ones came from WhatsApp.

Pyrus Tip: This extension works through GupShup — an official Meta partner and a paid service. Check out their website: https://www.gupshup.io. For pricing details, visit their pricing page or email them at devsupport@gupshup.io.

Step 1. Set Up Your Business Account

First, you'll need a Facebook Business Manager account. If you already have one, skip ahead.

Important: You'll need an active personal Facebook account to create a business one. Also, keep in mind — this service isn't available for IP addresses registered in Russia.

Log in to Facebook, go here, and click Create Business.

Fill out the form and hit Submit.

Then just follow the on-screen steps to verify your business and confirm your company info. Need more detail? Here's the official guide.

Step 2. Create an App in GupShup

  1. Go to https://www.gupshup.io and click Log in in the top-right corner. Log in however you like.

    Pyrus Tip: Make sure you have Admin rights in your Facebook Business Manager account.

  2. Click Create App to get started.

  3. Give your bot a name (this is how it'll show up to customers) and submit.

  4. Click Go to Dashboard.

  5. Hit Begin Go Live to start the activation flow.

  6. Choose whether you want to use a new phone number or an existing one for your bot.

  7. Follow the rest of the setup steps in GupShup. Once everything's verified, your bot will be live — and you'll be able to receive WhatsApp messages as tasks in Pyrus.

Step 3. Connect the Extension in Pyrus

  1. In Pyrus, go to your user settings and choose Extensions.

  1. Find the WhatsApp icon and click it.

    Then click Install.

  2. Pick the Pyrus form you want to use for incoming WhatsApp requests.

  3. Now enter your GupShup details:

    • WhatsApp phone number
    • App name
    • App ID
    • API token

  4. Then click Connect account.

    Pyrus Tip: To create or copy your API token and find your App ID, go to your app settings in GupShup.

  5. Once connected, you'll see the extension's own settings. Here you can:

    • Map the customer's name and message subject to fields in your form
    • Set a welcome message
    • Define when a follow-up message should become a new task (instead of continuing the old one)

    Pyrus Tip: Use the placeholder ${task:id} in your welcome message — it'll show the client their task number, so they can refer to it later.

  6. Toggle the extension to Active.

  7. After activation, Pyrus will generate a webhook URL for you.

  8. Copy that URL and go to your app's Webhooks settings in GupShup.

    • Select Gupshup format V2.
    • Choose which WhatsApp events you want to forward to Pyrus.

    • Turn the webhook on.

You're all set! From now on, every WhatsApp message will appear as a task in Pyrus. To reply, just click the green chat icon inside the task comment box and type your message.

Suspend or Remove the Integration

  • To suspend: go to the extension settings and switch it to Suspended.

  • To update credentials: click Reconnect account and enter the new details. Your settings and existing tasks won't be lost — you can continue conversations.

  • To remove completely: click the trash icon at the bottom of the settings page.

Was this article helpful?