LogoLogo
Get a demoLog inAcademyDevelopersMore docs
  • Bird CRM docs
    • Explore all products
    • Use cases
      • Bird for travel
        • Abandoned search recovery
        • Flight confirmation
        • Holiday search campaigns
        • Price change alerts
    • About Bird CRM
  • Inbox
    • Inbox
      • Concepts
        • Reports
      • Admin guide
        • Agents
          • Invite an agent to Inbox
          • Remove an agent from Inbox
          • FAQs
        • Tags
        • Routing
        • Teams
        • Feeds
        • Sender profiles
        • Reporting
      • Agent guide
        • 📚1. The basics
        • ⏰2. Your availability status
        • ✉️3. Send and receive messages
        • 💬4. Manage conversations
        • 👥5. View conversation participants
        • 👤6. View a contact's profile
  • Campaigns
    • Campaigns
      • Quickstarts
        • Send a campaign
      • Concepts
        • A/B tests
          • FAQs
        • Branded links
        • Calendar view
        • Campaign tags
        • Frequency limits
        • Scheduling
      • How-to
        • Schedule a campaign
        • Run an A/B test
        • Replicate a campaign
    • WhatsApp campaigns
      • How-to
        • Send a WhatsApp campaign
    • Email campaigns
      • How-to
        • Send an email campaign
    • SMS campaigns
      • Concepts
        • Best practices for MMS campaigns
      • How-to
        • Send an SMS campaign
    • Push notifications
      • How-to
        • Send a push notification campaign
    • New Campaign Builder
  • Automation
    • Journeys
      • Quickstarts
        • Create an abandoned cart recovery journey
      • Concepts
        • Journey templates
        • Journey runs
        • Journey insights
        • Journey reports
      • How-to
        • Use a send message step in a journey
        • Use a wait step in a journey
        • Use a conditional step in a journey
        • Use an update contact step in a journey
        • Use an end journey step in a journey
    • Flows
      • Quickstarts
        • Use template flows
        • Build an inbound flow
      • Concepts
        • Capabilities and limitations
        • Triggers
          • Agent triggers
          • Connector triggers
            • HubSpot triggers
          • Contact triggers
          • Conversation triggers
          • Feed item triggers
          • Message lifecycle triggers
          • Voice triggers
          • Webhook triggers
          • HTTP endpoint trigger
          • WhatsApp flow endpoint trigger
        • Actions
          • Bird API actions
            • Bots actions | API
            • Channel actions | API
            • Collaboration actions | API
            • Conversation actions | API
            • Engagements actions | API
            • Number management actions | API
          • Core actions
            • How to set up global variables in Flows
            • How to use the Filter Array Step
            • How to use the "Await Webhook" Step in Flows
          • Contact actions
          • Channel actions
          • Conversation actions
          • Connector actions
            • HubSpot actions
            • Open AI actions
          • Voice actions
      • How-to
        • Route conversations based on language
        • Route conversations based on sentiment
        • Set up a business hours auto-responder
        • Create a simple auto-responder
        • Set up conversational marketing
        • Create an FAQ bot
        • How to Match Regex in Flows
    • Approval Flow
  • Audience & Contacts
    • Sign-up forms
      • Quickstarts
        • Create a sign-up form
        • Create quizzes
      • Concepts
        • Sign-up process
        • Display
        • Colors
        • Targeting
        • Languages
        • Sign-up form analytics
    • Lists and segments
      • Quickstarts
        • Create a segment
      • Concepts
        • Segments
        • Lists
      • How-to
        • Create a segment based on contact activity
        • View contacts in a segment
        • Edit the setup of a segment
        • Delete a segment
        • Create a list
    • Contacts
      • Concepts
        • Contacts
        • Contacts directory
        • Contact profiles
        • Consent and subscriptions
          • Suppressions
          • Managing unsubscribes
          • Opt-ins, consent, and subscription statuses
            • Contacts with a 'blank' subscription status
      • How-to
        • Add contacts
        • Update the subscription status of your existing contacts
        • Send marketing campaigns to contacts with a 'blank' subscription status
        • Export contacts
        • How to bulk delete contacts
  • Content
    • Email templates
      • Concepts
        • Email content, styling, and personalization
        • Email design best practices
        • Advanced Email Templating
      • How-to
        • Create an email template
        • Import a custom HTML email
        • Use a prebuilt email template
        • Create personalized abandoned cart, browse and order placed emails
    • Message templates
      • Quickstarts
        • Create a message template
      • Concepts
        • Localization
        • Versioning
        • WhatsApp message templates
          • WhatsApp approved message templates
          • Reply to open conversation message template
          • Commerce messages
        • Apple Messages for Business
        • Push notifications
      • How-to
        • Localize a message template
        • Add variables to a message template
        • Create an SMS message template
        • Apple Messages for Business
          • Use dynamic variables in Apple Messages templates
          • Create a text Apple Messages template
          • Create an image Apple Messages template
          • Create a location Apple Messages template
          • Create a file Apple Messages template
          • Create a rich link Apple Messages template
          • Create a list picker Apple Messages template
          • Create authentication Apple Messages message types
          • Create a quick reply Apple Messages template
          • Create a time picker Apple Messages template
          • Create an iMessage App message template
          • Create a payment Apple Messages template
        • WhatsApp message templates
          • Create a WhatsApp approved message template
          • Create a reply to open conversation WhatsApp message template
          • Create a single product WhatsApp message template
          • Create a catalog WhatsApp message template
          • Create a coupon WhatsApp message template
          • Create an action WhatsApp message template
          • Create a limited time offer WhatsApp message template
          • Create a carousel WhatsApp message template
          • Create Approved WhatsApp Flows Template
          • Create reply to open conversation WhatsApp Flows Template
        • Create Push Notifications message templates
    • Chat widgets
      • Concepts
        • Send and receive messages
      • How-to
        • Build and install a chat widget on a Shopify store
        • Build and install a chat widget on your website
    • Media Library
      • How to Upload Images to the Media Library
    • Translation files
      • Creating and using translation files
    • External Data Sources
    • Lookup Tables
    • Discounts
    • Lookup tables
      • Managing lookup tables
      • Using lookup tables in Flows
    • Products
      • Custom Product Catalog Source
  • Analytics
    • Analytics
      • Concepts
        • Reporting metrics
        • Understanding the Attribution Model
        • List-unsubscribe in email headers
        • Understand Open Tracking
    • Channel analytics
      • Concepts
        • Channel logs
      • How-to
        • Analyze the performance of your channels
    • Campaign reports
      • Concepts
        • WhatsApp campaign reports
        • Email campaign reports
        • SMS campaign reports
      • How-to
        • View campaign reports
        • View A/B test campaign reports
        • See an overview campaign performance
  • Channels
    • Channels
      • Concepts
        • Quiet hours
      • Quickstarts
        • Find and install a channel
        • View information about an installed channel
        • View Channel Logs
      • Supported channels
        • Apple Messages for Business
          • Quickstarts
            • Install Apple Messages for Business
            • Use Apple Messages for Business
          • Concepts
            • Typing indicators
            • User device capabilities
          • How-to
            • Complete onboarding
            • Use entry points
            • Route messages
            • Send messages
            • Use Apple Pay
        • Email
          • Install email
          • Forwarding emails from Gmail
          • IP pools
          • Configure BIMI
        • Facebook Messenger
          • Install Facebook Messenger
          • Use Facebook Messenger
          • Facebook Messenger message types
        • Instagram Messaging
          • Install Instagram Messaging
          • Use Instagram Messaging
          • FAQs and Best Practices
          • Instagram message types
        • LINE
          • Install LINE
        • LinkedIn Pages Messaging
          • Install LinkedIn Pages messaging
          • Use LinkedIn Pages Messaging
          • LinkedIn Pages Messaging Types
        • Numbers
          • Quickstarts
            • Find and buy a new number
            • Activate a number
          • Concepts
            • Number types
            • Know-Your-Customer (KYC)
            • Activation, approval, and rejection
            • Number restrictions in China
          • How-to
            • Use a number
            • Cancel a number
            • Troubleshooting
            • FAQs
        • Push notifications
        • Google RCS
          • Create a Google RCS agent and install Google RCS as a channel
          • Testing and launching your agent
          • Create a Google RCS message template
          • RCS message template types
          • Create and send a Google RCS campaign
          • Create an RCS lead nurture journey with a fallback
          • Use RCS with an AI Agent
          • Grow RCS subscribers with a sign-up form
        • SMS
          • Quickstarts
            • Install SMS
            • Toubleshoot SMS Deliveries Faliures
            • (Missing) SMS delivery status
            • Troubleshoot Channel Health
          • Concepts
            • SMS parts and message length
            • SMS message types and compliance
            • Opt-in and opt-out compliance
            • Choose the right sender : Availability and restrictions by country
              • SMS Country Information Guide: Africa (A-L)
              • SMS Country Information Guide: Africa (M-Z)
                • South Africa
                • Nigeria
              • SMS Country Information Guide: Asia (A-K)
                • Japan
                • India
                • China
              • SMS Country Information Guide: Asia (L-Z)
                • Malaysia
                • Singapore
              • SMS Country Information Guide: Caribbean
              • SMS Country Information Guide: Central America
              • SMS Country Information Guide: Europe (A-M)
              • SMS Country Information Guide: Europe (N-Z)
              • SMS Country Information Guide: Middle East
                • United Arab Emirates
              • SMS Country Information Guide: North America
                • Messaging Best Practices - NORAM SMS / MMS
                • Canada
                • United States
                • Prohibited Content - NORAM SMS / MMS
              • SMS Country Information Guide: Oceania
                • New Zealand
                • Australia
              • SMS Country Information Guide: South America
            • MMS sizes and limitations
            • Automatic sender selection
            • SMS Registration
              • Use case requirements for SMS Registration
              • Setting up a SMS consent flow
              • SMS Privacy Policies
              • SMS Toll-free number
                • TFN Verification
                • Additional Costs for using TFN
                • How-to Guides
                  • Purchase a Toll Free Number via Bird
                  • Register a US or Canadian TFN for SMS via Bird
              • SMS 10DLC
                • How-to Guides
                  • Purchase a 10DLC number via Bird
                  • Register a 10DLC brand via Bird
                  • Register a 10DLC campaign via Bird
                  • Install SMS 10DLC
                  • Delete inactive 10DLC campaigns to avoid additional charges
                • Throughput and Daily Caps
                • Brand registration
                • Campaign registration
                • Additional costs for using 10DLC
                • 10DLC FAQs
            • Page 1
        • WhatsApp
          • Quickstarts
            • Before you start
            • Install WhatsApp
          • Concepts
            • WhatsApp for Business
            • Accounts and verification levels
              • Verified Facebook Business Manager Account
              • Official WhatsApp Business Account (Green tick)
            • Use WhatsApp
            • WhatsApp message types
            • WhatsApp's Customer Care Window
            • FAQs
          • How-to
            • Verify your Facebook Business Manager Account
            • Set up commerce messaging
              • Product inquiries
              • Product orders
            • Create a WhatsApp Flow
              • Create a flow
              • Testing your flow
              • Publishing and sending your flow
              • Handling Flow submission
            • Enable conversational components
            • Become a WhatsApp Tech Provider
              • Onboard as a Tech Provider
              • Connecting to Bird as solutions provider
              • Meta Tech Partner Migration 2024
            • Migrate from Bird to another BSP (Business Service Provider)
        • Telegram
          • Install Telegram
          • Bot commands setup
  • AI
    • AI
      • Quickstarts
        • Create an FAQ model
        • Build a detect intent model
      • Concepts
        • AI Assistants
          • Agent Assistant
          • Flows Assistant
          • Studio Assistant
          • FAQ Assistant
          • Audience Assistant
        • AI flow actions
        • AI integrations
        • Detect language: Supported languages
      • How-to
        • Set up and deploy automated FAQs
        • Set up and deploy detect intent models
    • AI Agents
      • Concepts
        • Knowledge bases
        • OpenAI token usage
      • How-to
        • Build a knowledge base
        • Set up an AI Agent
        • Deploy an AI Agent
  • Payments
    • Bird Pay (Beta)
      • Quick Start
        • How to get Bird Pay access?
      • Concepts
        • Onboarding
        • Payment Link
        • Wallet
          • Transfer
          • Recipient
        • Payments
          • Disputes
        • My customers
        • Payouts
        • Payment methods
        • Bird Pay Coverage
        • Strong Customer Authentication (SCA)
      • How-to
        • Create a Payment link
        • Refund a Payment
        • Manage Payout
        • Respond to a Dispute
        • How to set up MFA using the Authenticator app?
      • FAQs
        • Why was my onboarding unsuccessful?
        • How do I update my business address?
        • What are foreign currency fees on my Bird Payments?
        • How to raise an issue with Bird Pay with support?
  • Integrations
    • Integrations
      • Quickstarts
        • Find and install an integration
      • Concepts
        • Integration data sync
      • Supported integrations
        • ActiveCampaign
        • OPERA Cloud
        • Calendly
        • Easyship
        • Google Cloud Translation AI
        • HubSpot
        • Magento 1
        • Magento 2
        • Monday.com
        • Notion
        • OpenAI
        • Rebrandly
        • Salesforce
        • Shopify
        • SugarCRM
        • Zoho CRM
        • TikTok Ads
        • Typeform
        • WooCommerce
        • Zendesk Support
        • Google BigQuery
        • Snowflake
        • Amazon S3
        • Salesforce Marketing Cloud
        • Meta ads
        • Google Ads
      • How-to
        • How to integrate the Salesforce Connector on Bird?
        • How to Delete Contacts in Bird when Deleted in Salesforce
  • Account & Billing
    • Account
      • Organization settings
        • General
        • Single-Sign On (SSO)
          • Set up Single-Sign On (SSO)
          • Enforce Single-Sign On (SSO)
          • Entra ID
          • Google Workspaces
          • Okta
        • SCIM
          • Okta setup
          • Okta setup - Workspace IAM
          • Entra ID
        • Security Settings
        • Business profile
        • Workspaces
        • Plans & Billing
        • Wallets
        • Users
        • Access policies
        • Access roles
        • Access keys
        • How to find your Organization ID
        • How to find a Workspace ID
        • How to limit a user's access to a single workspace
        • How to download usage report?
        • How to pay (settle) invoices via wallet?
  • Help & Reference
    • Bird support
      • Invite Bird support
    • Deliverability & compliance
      • Email compliance - Bulk sending
      • United States SMS/MMS compliance
        • Key US Regulations
        • General US content restrictions
        • US SMS/MMS compliance
        • US Voice compliance
        • US state-level laws and regulations
        • US compliance & best practices checklist
        • US compliance FAQs
      • Singapore SMS Compliance
    • Data protection
      • Approved subprocessors
    • Release notes
    • Glossary
Powered by GitBook
On this page
  • What you'll need
  • Step one: Access Flows
  • Step two: Add and set up a trigger
  • Step three: Reply with a list message
  • Step four: Wait for a response
  • Step five: Send some test data to your flow
  • Step six: Use a conditional action
  • Step seven: Assign tickets to teams in Inbox
  • Step eight: Handle messages that aren't for 'Support' or 'Sales'
  • Step nine: Follow up if there is no answer
  • Step ten: Polish and publish the flow
  • Step eleven: Test and troubleshoot

Was this helpful?

  1. Automation
  2. Flows
  3. Quickstarts

Build an inbound flow

Learn how to access, build, and deploy a basic inbound flow.

Last updated 11 months ago

Was this helpful?

Inbound flows are the most commonly-used flows. They handle incoming customer inquiries.

Before you start, make sure you've familiarized yourself with the .

What you'll need

  • Access to Flows.

  • At least one installed channel (we're going to be using WhatsApp).

  • Two in Inbox, one for 'Support' and one for 'Sales'.

Step one: Access Flows

Context

Flows is available in the Process Automation section of your workspace.

  1. Click your workspace name in the top left-hand corner of your screen.

  2. Click Process Automation, then select Flows from the sidebar.

  3. Click New flow in the top right-hand side of your screen, then select Create from scratch.

Step two: Add and set up a trigger

Context

  • All flows start with a trigger—an event that makes the flow run.

  • A conversation is created automatically in Inbox when a customer messages you.

  • When a customer messages you for the first time, they automatically become a contact in Bird.

In this example, we're going to trigger our flow when a new conversation is started on a specific channel.

  1. In the Trigger section, select Conversation.

  2. In the Select a channel section, select your installed channel. We're going to choose WhatsApp.

  3. If you have multiple versions of the channel installed, such as more than one WhatsApp number, they will be listed in the drop-down in the Select an instance section. Select the one that you want to use to trigger this flow.

  4. In the Select a trigger event section, select Conversation created.

  5. The Select participant type section will be prefilled with Contact. Leave this as it is.

  6. Click Save to complete the trigger setup.

Step three: Reply with a list message

Context

  • Once triggered, flows perform tasks, known as actions.

  • List messages have clickable buttons, known as items. You can add up to 10 items to a single list message.

Now that our trigger has been set up to recognize when our WhatsApp number is used by a customer to start a new conversation, we need to ask the flow to send an automated reply to the customer.

In this example, we're going to reply with a list message.

  1. Click Add new action.

  2. Use the search bar to find the Send list message to conversation flow action.

  3. [Optional] In the Title field, enter a headline for your message. This can be something that describes the content that you're about to share.

  4. In the Message content field, enter the body text of your content.

  5. [Optional] In the Footer field, enter a footer for your message.

  6. In the Items section, click + Add new item.

  7. In the Title field, enter the text to want to display on the button. We're going to use 'Talk to sales'. You can leave the Description field blank.

  8. Click + Add new item again.

  9. In the Title field, enter the text to want to display on the button. We're going to use 'Talk to support'. You can leave the Description field blank.

Step four: Wait for a response

Context

  • Wait actions pause a flow until it receives a response.

  • Because a flow can't wait indefinitely, wait actions will fail after a certain amount of time has passed. By default, they fail after five minutes.

  • You can change how long the flow waits before it fails. For example, if you're using email, you might want to extend the wait time from five minutes to three hours.

Once our list message has been sent, the flow needs to listen for a reply to that list message. We'll use a Wait for conversation message to tell the flow to wait.

  1. Click Add new action.

  2. Use the search bar to find the Wait for conversation message flow action.

  3. [Optional] Change the duration of the Fail after field.

  4. Click Next.

Step five: Send some test data to your flow

Context

  • While creating a flow, you'll often need to send some test data so that you can complete the setup.

  • This data will appear in Bird as a payload.

  • Payloads are structured packets of data that flows can read and pass between triggers and actions.

Our flow is now waiting for a reply to the list message we sent. To configure this step correctly, we need to simulate a reply to that message.

  1. Save the WhatsApp number that you used to set up the flow trigger to your mobile device.

  2. Open WhatsApp on your mobile, and send a message to that number.

  3. In your flow, click the trigger to expand the configuration.

  4. In the Test section, click Update test data.

  5. The payload will be updated, and will now contain information about the message you sent to your WhatsApp number.

  6. Scroll down to the Wait for conversation message step and click Update test.

Step six: Use a conditional action

Context

  • A conditional action always starts with two branches. You can add more branches as required.

  • Conditionals determine what actions happens next based on whether specific criteria are met.

Now that we've simulated a reply, the flow needs to check the content of the reply. Most customers will use the reply buttons to select either 'Support' or 'Sales'.

  1. Scroll to the end of your flow and click Add new action.

  2. Use the search bar to find the Conditional flow action.

  3. Click Branch A's name, and rename it Support.

  4. In the Support branch, click the Variables field.

  5. Click Steps > Wait for conversation message > event > message > body > text.

  6. From the Select operator drop-down, select (String) equals.

  7. In the Value field, type Talk to sales.

  8. Click Branch B's name, and rename it Sales.

  9. In the Support branch, click the Variables field.

  10. Click Steps > Wait for conversation message > event > message > body > text.

  11. From the Select operator drop-down, select (String) equals.

  12. In the Value field, type Talk to support.

  13. Click Next.

  • When using the (String) equals operation, the flow will check that the reply content exactly matches the configured value.

Step seven: Assign tickets to teams in Inbox

Now that you've added branches to your flow, it's become a bit more complex. For a clearer view, scroll all the way up to the top of your screen and click Tree view.

Based on the content of the reply to the list message we sent, the flow will need to route the customer to either the 'Support' team, or the 'Sales' team.

  1. Click the Support branch.

  2. Within the branch, click Add new action.

  3. Use the search bar to find the Assign to team in Inbox flow action.

  4. In the Team ID field, select the appropriate Support team from the list.

  5. Click Next.

  6. Select the Sales branch.

  7. Within the branch, click Add new action.

  8. Use the search bar to find the Assign to team in Inbox flow action.

  9. In the Team ID field, select the appropriate Sales team from the list.

  10. Click Next.

Step eight: Handle messages that aren't for 'Support' or 'Sales'

Let's add a new branch to the conditional to handle those responses by asking them to select one of the predefined options, and re-sending them the list message.

  1. While in the Tree view, look for the dotted line next to your two branches, and click Add new action.

  2. Use the search bar to find the Send plain text message to conversation flow action.

  3. In the message content, enter some text to instruct your customer to choose one of the predefined options.

  4. Click Next.

  5. Below this action, click Add new action.

  6. Use the search bar to find the Jump flow action.

  7. Choose the Send List message to Conversation flow action from the Jump to action dropdown.

  8. [Optional] Set a maximum number of jumps.

  9. Click Next.

  10. Below this action, click Add new action.

  11. Use the search bar to find the Update feed item flow action.

  12. In the settings, click the Closed toggle to the on position.

  13. Click Next.

Step nine: Follow up if there is no answer

Sometimes you won't receive a response to the list message. Let's set up a branch to handle situations like this.

  1. From the Tree view, click the Wait for conversation message flow action.

  2. Click Advanced configuration.

  3. Under Error handling, select Ignore and continue.

  4. Close the Advanced configuration panel.

  5. In the Fail After section, decrease the Duration to 15 seconds.

  6. Click Next.

  7. Send another test message to the WhatsApp number.

  8. From the Tree view, click the Conditional flow action.

  9. Add a new branch.

  10. Name the branch Error.

  11. Set up the Error variable for If error is present.

  12. Move this branch above the other branches you have created.

Step ten: Polish and publish the flow

  1. Give your flow a name that you'll recognize.

  2. Add a short description to your flow steps.

  3. Click Publish draft in the top right-hand corner of your screen.

Success! Your flow is now live.

Step eleven: Test and troubleshoot

Now that your flow has been published, you can test it by sending a new message to the WhatsApp number.

If your flow doesn't seem to be triggering, follow these steps:

  1. Click the workspace name in the top left-hand corner of your screen.

  2. Select either Marketing or Customer Service.

  3. Go to Inbox.

  4. Use the search bar to look for an open ticket for your own contact by typing in your phone number.

  5. Assign the ticket to yourself, then close it.

  6. Re-trigger the flow by sending a WhatsApp message from your phone.

Good to know: Tests conducted before are free of charge.

Make sure the values you add here exactly match the values that you added to the items in your .

If the recipient of your list message decided not to click either the 'Support' or 'Sales' buttons, and instead replied with a free-form message, they won't match either of the branches you configured in .

capabilities and limitations of flows
teams
publishing the flow
list message
step six