# Bird Documentation

## Start using Bird

Set up an account, import your customer data, and learn how to start using Bird for marketing, sales, and payments.

[Get a demo →](https://bird.com/demo)

***

### Getting started: most popular articles

[Add users to your organization](https://docs.bird.com/applications/settings/account/organization-settings/users#add-a-user-to-your-organization)

[Setup your first channel](https://docs.bird.com/applications/channels/channels#supported-channels)

[Install a connector](https://docs.bird.com/applications/automation/flows/concepts/triggers/connector-triggers#available-connectors)

[Import your contacts into Bird](#import-contacts-with-a-csv-file)

[Get started with AI employees](https://docs.bird.com/applications/ai-features/ai-agents/how-to/create-your-first-ai-employee)

***

### Find your use case

You have to [register](https://bird.com/demo) for a Bird account before you can use any of these products or solutions. 

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Build a campaign</strong></td><td>Build and send an Email, SMS, WhatsApp, Push or RCS Campaign.</td><td></td><td><a href="#send-email-campaigns">#send-email-campaigns</a></td></tr><tr><td><strong>Build a Journey</strong></td><td>Create targeted marketing sequences that adapt to customer actions.</td><td></td><td><a href="journeys/journeys">journeys</a></td></tr><tr><td><strong>Get contacts into Bird</strong></td><td>Bring your contacts into Bird, with CSV uploads or data flows.</td><td></td><td><a href="#get-contacts-into-bird">#get-contacts-into-bird</a></td></tr><tr><td><strong>Target customers</strong></td><td>Manage your audience.</td><td></td><td><a href="#target-customers">#target-customers</a></td></tr><tr><td><strong>Design content</strong></td><td>Craft engaging message templates.</td><td></td><td><a href="#design-emails">#design-emails</a></td></tr><tr><td><strong>Build webforms</strong></td><td>Collect customer contact details and embed forms on your store or website.</td><td></td><td><a href="sign-up-forms">sign-up-forms</a></td></tr><tr><td><strong>Measure campaign performance</strong></td><td>See your campaign results.</td><td></td><td><a href="#measure-campaign-performance">#measure-campaign-performance</a></td></tr></tbody></table>

### Get contacts into Bird

To bring your contacts into Bird, you can install an [integration](https://docs.bird.com/applications/integrations), such as [Shopify](https://docs.bird.com/applications/integrations/integrations/supported-integrations/shopify) or [HubSpot](https://docs.bird.com/applications/integrations/integrations/supported-integrations/hubspot), or import contacts with a [CSV file](https://docs.bird.com/applications/audience/contacts/how-to/create-contacts). Each contact will have a [profile](https://docs.bird.com/applications/audience/contacts/concepts/contact-profiles), where information about subscription statuses, event history, and custom and integration properties are stored.

<details>

<summary>Import contacts with a CSV file</summary>

[See the full article →](https://docs.bird.com/applications/audience/contacts/how-to/create-contacts#bulk-import-new-contacts-from-a-csv)

1. Prepare your CSV file using the correct format, ensuring it includes at least one identifier like a phone number or email for each contact. Use the provided demo file as a template to avoid formatting issues.
2. Access the "Contacts" section from the side panel, click **Add Contact**, then **Import from CSV**. You can drag and drop the file or browse to select it from your device, then review it.
3. If the CSV file includes subscription statuses, you can skip this step. Otherwise, update the subscription status for each contact based on their opt-in preferences for marketing messages. If no marketing subscriptions are present, select **Import without updating subscription status**.
4. During import, you can add contacts to an automatically-generated list named with the import's date and time, or to new or existing lists. This can be customized during the import process.
5. Post-import, visit the **Imports** tab to view details of each import, such as the file name, lists added to, contacts skipped or updated, total contacts, and timestamps of import activities.

</details>

<details>

<summary>Import contacts by installing an integration</summary>

[See the full article →](https://docs.bird.com/applications/integrations/integrations/quickstarts/find-and-install-an-integration)

1. Install an integration by clicking your name at the bottom left-hand side of your screen, then clicking **Integrations**.&#x20;
2. Find and install your integration. Once you install an integration, contact data is automatically imported and contact profiles in Bird are updated.

**See also**

* [Integration data sync →](https://docs.bird.com/applications/integrations/integrations/concepts/integration-data-sync)

</details>

### Target customers

Manage your audience and get granular with your targeting by creating dynamic [segments](https://docs.bird.com/applications/audience/lists-and-segments/concepts/segments) and static [lists](https://docs.bird.com/applications/audience/lists-and-segments/concepts/lists).

<details>

<summary>Create a segment</summary>

[See the full article →](https://docs.bird.com/applications/audience/lists-and-segments/quickstarts/create-a-segment)

1. Navigate to **Audience** > **Lists & segments**.
2. Click **Create new** > **Create segment**.
3. Enter a name for your segment and an optional description.
4. In the **Segment definition** section, decide if the contacts should match "All" or "Any" of the specified conditions.
5. Apply filters by attributes or condition groups for precise audience targeting.
6. Utilize "and/or" filters to refine your selection further.
7. Preview the matching contacts, and when satisfied, hit the **Save Segment** button.

See also:

* [Contact activity](https://docs.bird.com/applications/audience/contacts/concepts/contact-profiles#activity)
* [Create a segment based on contact activity](https://docs.bird.com/applications/audience/lists-and-segments/how-to/create-commonly-used-segments)

</details>

### Design content

To craft your emails in Bird, you can choose from a library of [pre-designed templates](https://docs.bird.com/applications/content/email-templates/how-to/use-a-prebuilt-email-template) or [design your own from scratch](https://docs.bird.com/applications/content/email-templates/how-to/create-an-email-template). Our drag-and-drop email builder is easy to use, and templates can be personalized with both customer data and products from your ecommerce store.

<details>

<summary>Use a prebuilt email template</summary>

[See the full article →](https://docs.bird.com/applications/content/email-templates/how-to/use-a-prebuilt-email-template)

1. Navigate to **Content > Email templates > Template gallery**.
2. Search or browse to find a template.
3. Click on the template for more information.
4. To use it, click **Clone template**, set up your project, and click **Create template**.
5. Edit the template as needed and click **Publish** when you're ready to use it.

</details>

<details>

<summary>Create an email template from scratch</summary>

[See the full article →](https://docs.bird.com/applications/content/email-templates/how-to/create-an-email-template)

1. Navigate to **Content > Email templates > Create blank email**.
2. Name your email, select a locale, and click **Create new email**.
3. Choose **Build from scratch** and click **Get started**.
4. Enter a subject line, add custom or prebuilt content blocks, and insert any variables.
5. Use desktop and mobile preview options in the email builder to check the email's appearance. For a more accurate view, send test emails to various email clients and devices.
6. Click **Publish** when you're ready to use it.

See also:

* [Email content, styling, and personalization](https://docs.bird.com/applications/content/email-templates/concepts/email-content-styling-and-personalization)

</details>

### Send campaigns

Send your marketing campaign directly to your customers' inboxes by sending them an email campaign.

<details>

<summary>Send an email campaign</summary>

[See the full article →](https://docs.bird.com/applications/campaigns/email-campaigns/how-to/send-an-email-campaign)

1. Confirm that your Email channel, [email template](https://docs.bird.com/applications/content/email-templates/how-to/create-an-email-template), and opted-in customer segment or list are ready.
2. Go to **Campaigns > Create campaign**.
3. Name your campaign, choose **Email** as the type, optionally add tags, then **Save and continue**.
4. Choose target lists or segments from the **Send to** dropdown. Optionally exclude specific lists with **Don't send to**.&#x20;
5. Click **Continue to content**.
6. Select the sending account and input your sender details.
7. Choose and configure your email template.
8. Check the message preview, select a test contact, and **Send a test message**.
9. Choose **Schedule or send**, select **Send now** or schedule for later.

See also:

* [Install Email](https://docs.bird.com/applications/channels/channels/supported-channels/email/install-email)
* [Create an email template](https://docs.bird.com/applications/content/email-templates/how-to/create-an-email-template)

</details>

<details>

<summary>Send a WhatsApp campaign</summary>

[See the full article →](https://docs.bird.com/applications/~/revisions/OYoUnNZ9nlJjA0Stlc4P/campaigns/whatsapp-campaigns/how-to/send-a-whatsapp-campaign)

1. Confirm that your WhatsApp channel, WhatsApp template, and opted-in customer segment or list are ready.
2. Go to **Campaigns > Create campaign**.
3. Name your campaign, choose **WhatsApp** as the type, optionally add tags, then **Save and continue**.
4. Choose target lists or segments from the **Send to** dropdown. Optionally exclude specific lists with **Don't send to**.&#x20;
5. Click **Continue to content**.
6. Select the sending account and input your sender details.
7. Choose and configure your email template.
8. Check the message preview, select a test contact, and **Send a test message**.
9. Choose **Schedule or send**, select **Send now** or schedule for later.

See also:&#x20;

* [Create a WhatsApp template](https://docs.bird.com/applications/content/message-templates/how-to/whatsapp-message-templates/create-a-whatsapp-approved-message-template)
* [Install WhatsApp](https://docs.bird.com/applications/channels/channels/supported-channels/whatsapp/quickstarts/install-whatsapp)

</details>

### Measure campaign performance

Spot trends, see which campaigns have performed the best, and dive into detailed data.

<details>

<summary>View campaign reports</summary>

[See the full article →](https://docs.bird.com/applications/analytics/campaign-reports/how-to/view-campaign-reports)

1. Navigate to **Campaigns**.
2. Select your campaign, and click **View report**.

**Email Campaigns:**

* **Overview Tab**: Shows performance including delivery rates, open rates, and click rates.
* **Engagement Tab**: Highlights spam complaints and unsubscribes.
* **Bounce Tab**: Details on bounced emails, including types of bounces and bounce rates.
* **Rejection Tab**: Information on rejected emails and delivery failures.
* **Deliverability Tab**: Insights into email deliverability issues.

**WhatsApp Campaigns:**

* **Overview Tab**: Summarizes performance metrics like delivery and read rates.
* **Failure Reasons**: Explains why campaigns failed.

**SMS Campaigns:**

* **Overview Tab**: Presents sending and delivery performance.
* **Failure Reasons**: Details reasons for campaign failures.

Each tab presents critical data and visualizations to understand and improve your marketing efforts.

</details>