# Birdie’s Integration Paths

## Understanding Birdie’s Integration Paths

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/GKTGY0GT24.png)

Birdie offers several ingestion methods, each designed for different levels of data control, compliance, and flexibility. Selecting the right option depends on your organization’s data maturity, security policies, and technical capabilities.

<table><thead><tr><th>Integration Method</th><th>Best For</th><th>Typical Use Case</th><th>Effort (Client)</th><th width="137">Effort (Birdie)</th><th>Flexibility</th></tr></thead><tbody><tr><td>Native Connectors</td><td>Standard API-based platforms</td><td>Feedback systems like Zendesk, Intercom, Salesforce, Qualtrics</td><td>Low</td><td>Medium</td><td>Low</td></tr><tr><td>Data Lake / File-based Ingestion</td><td>Centralized enterprise data management</td><td>Data joins, anonymization, compliance requirements</td><td>High</td><td>Medium</td><td>High</td></tr><tr><td>REST Ingestion API</td><td>Developer-led organizations</td><td>Software-driven ingestion pipelines</td><td>Medium–High</td><td>Medium</td><td>Very High</td></tr><tr><td>Custom Solutions (Professional Services)</td><td>Unique or multi-source architectures</td><td>Orchestration across multiple systems, unsupported APIs</td><td>Variable</td><td>High</td><td>Maximum</td></tr></tbody></table>

## When to Choose Each Option

### Native Connectors

Choose this when:

* Your data resides in well-known, API-accessible SaaS platforms (e.g., Salesforce, Zendesk, Intercom).
* You want the fastest and simplest path to integration.
* Your security team is comfortable with granting API credentials.
* You only need feedback data ingestion, without external data joins or transformations.

Avoid this when:

* You need to join or normalize values from multiple platforms.
* Your organization enforces strong data residency or anonymization rules.
* You require ingestion of versioned or historical customer data.

Example Scenario:\
A CX team wants to ingest recent survey results from Qualtrics directly into Birdie for sentiment analysis — minimal transformation needed, so a Native Connector is ideal.

### Data Lake / File-based Ingestion

Choose this when:

* You already centralize your data in systems like BigQuery, Snowflake, or you can easily export data int S3/GCS/Azure.
* You need to join multiple data sources before ingestion (e.g., linking feedback to profiles or support tickets).
* You must comply with strict PII masking, anonymization, or governance policies.
* You require full control over data preparation, schemas, and validation.

Avoid this when:

* You lack internal data engineering capabilities or infrastructure to manage pipelines.
* Your team cannot maintain recurring data exports.

Example Scenario:\
An enterprise client merges feedback data from Salesforce and Zendesk into Snowflake, where all PII is hashed. Birdie ingests the final harmonized dataset from Snowflake.

### REST Ingestion API

Choose this when:

* Your engineering team prefers to build and maintain direct API integrations.
* You need event-driven ingestion or fine-grained control over data payloads.
* You want to automate custom validations or enrichments before sending data to Birdie.
* You need a fully automated, developer-managed ingestion flow.

Avoid this when:

* You have limited development resources or short project timelines.
* Your data exists mostly in third-party SaaS tools already covered by Birdie’s connectors.

Example Scenario:\
A software team builds a middleware that listens to internal CRM events and pushes structured JSON payloads to Birdie’s REST API, enabling near real-time ingestion.

### Custom Solutions (Professional Services)

Choose this when:

* Your ingestion needs don’t fit within any of the standard connector or ingestion models.
* You need multi-source orchestration (e.g., combining Zendesk + Salesforce + internal CSV).
* You require custom data joins, enrichments, or transformations not supported natively.
* The integration involves unsupported authentication or connection methods (e.g., VPN, Kafka, SOAP APIs).

Examples of Custom Needs:

* Combining Genesys and Zendesk tickets using ticket\_id joins.
* Joining Salesforce Account data with Intercom conversations by account\_id.
* Parsing proprietary file formats or connecting through internal VPNs.

## How to Identify When a Custom Solution Is Needed

You can identify custom requirements early by looking for non-standard ingestion behaviors such as:

| Indicator                                               | Meaning                                        | Recommendation                             |
| ------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------ |
| Multiple source systems must be merged before ingestion | Requires custom orchestration logic            | Engage Professional Services               |
| Data must be enriched or joined using custom fields     | Field-level mapping exceeds connector defaults | Consider custom transformations            |
| Internal policies prohibit direct API integrations      | Security or compliance constraints             | Use Data Lake ingestion or custom pipeline |
| Proprietary or uncommon data source                     | Unsupported platform or authentication type    | Custom connector or file automation        |

## How to Size and Scope a Custom Solution

Properly sizing your ingestion project helps estimate delivery time, effort, and cost accurately. Birdie uses three size tiers (S, M, L) across all services. Below are guidelines to help you classify your custom requirement.<br>

Small (S)

* Scope: Single data source or one new connector.
* Complexity: Minimal transformation (renaming, basic filtering).
* Effort: 20–40 hours.
* Example: Ingesting a new CSV export into Birdie with standardized columns.

Medium (M)

* Scope: Two connected data sources or moderate transformation.
* Complexity: Requires joins or conditional field normalization.
* Effort: 40–80 hours.
* Example: Matching Zendesk and Salesforce data using shared account\_id.

Large (L)

* Scope: Three or more source platforms or complex transformation logic.
* Complexity: Involves multiple authentication layers or advanced orchestration (Kafka, VPN, custom endpoints).
* Effort: 80+ hours.
* Example: Integrating data from Genesys, Zendesk, and internal databases through custom scripts and mappings.

## Collaboration and Project Workflow

When engaging with Birdie’s Professional Services for ingestion projects, the collaboration process typically follows these stages:<br>

1. Discovery & Scoping
   * Define data sources, field mappings, and compliance constraints.
   * Identify ingestion method(s) and potential custom requirements.
2. Effort Estimation & Proposal
   * Birdie’s team estimates the complexity (S/M/L).
   * A detailed proposal and pricing estimate are shared.
3. Implementation & Validation
   * Connector or custom flow is built, configured, and validated with sample data.
   * Adjustments are made for transformation rules and data normalization.
4. Go-Live & Support
   * First ingestion run monitored jointly.
   * Birdie provides handover documentation and operational guidelines.

## Decision Flow Summary

A visual decision flow can be included in your presentation deck or appended as a diagram:

Start → Identify Source Platform

* Is it a commercial platform with an open API?\
  → Native Connector
* Do you need to join or anonymize data?\
  → Data Lake / File-based
* Do you prefer developer control with API access?\
  → REST Ingestion API
* None of the above or multi-source orchestration required?\
  → Custom Professional Service