> For the complete documentation index, see [llms.txt](https://ask.birdie.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/stilingue.md).

# Stilingue

### Overview

Stilingue is a social listening platform that monitors public mentions of your brand across social networks (Twitter/X, Facebook, Instagram, LinkedIn, TikTok), news, blogs and review sites such as Reclame Aqui. This integration imports those monitored posts into Birdie as conversations.

### Requirements

* An active Stilingue research/panel with API access enabled on your contract.
* Account master permissions in Stilingue to create an API token.

### Setup in Stilingue

{% stepper %}
{% step %}

#### Access your research settings

Log in to [Warroom](https://warroom.stilingue.com.br) and, from the side menu, go to **"Otimizar > Editar pesquisa"** for the research/panel you want to connect.

![Otimizar > Editar Pesquisa in the Warroom](/files/A2ewux6jzdVHLwvq8mR2)
{% endstep %}

{% step %}

#### Find the API-Token section

On that page, look for the section **"Crie a API-Token para essa pesquisa"**.

![Crie a API-Token para essa pesquisa](/files/rdlZlMEylD1r7wKaBGwc)
{% endstep %}

{% step %}

#### Create the API-Token

Click **"Criar API-Token"**, then confirm by clicking **"Sim"** in the dialog that opens.
{% endstep %}

{% step %}

#### Copy the token

Copy the token that's generated, you'll share this with Birdie in the next step.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
If you don't see the **"Crie a API-Token"** section, contact your Stilingue CSM, it usually means your contract doesn't have API access enabled, or your user doesn't have master permissions.
{% endhint %}

### Share Connection Details with Birdie

To configure the integration, securely provide Birdie with the following information.

```json
{
  "connection_details": {
    "token": "YOUR-STILINGUE-TOKEN",
    "channels": ["CHANNEL-1", "CHANNEL-2"]
  }
}
```

| Section              | Field      | Required | Description                                                                                                    |
| -------------------- | ---------- | -------- | -------------------------------------------------------------------------------------------------------------- |
| `connection_details` | `token`    | Yes      | The API token generated for your research/panel.                                                               |
| `connection_details` | `channels` | No       | List of Stilingue channels to import (e.g. `Twitter`, `Facebook`). Omit to import every channel on your panel. |

[Share credentials securely](/integrations-and-data-ingestion/securely-sharing-credentials-for-data-integration.md) with the Birdie team. Never send credentials via email or unencrypted channels.

### Data in scope

* Every post monitored by your Stilingue panel in the imported time window: text, author, channel, URL, sentiment, and engagement metrics (likes, shares, interactions).
* Replies/comments to a post are linked back to it when that information is available. Some social platforms limit how much of this data can be retrieved, so most posts come in as a single message rather than a full conversation thread.
* Historical range depends on how far back your Stilingue panel has collected data.

#### Channels

By default we import every channel available on your panel. If you'd rather import only a subset, share the list of channels you want with Birdie (see `channels` above). Available channels are:

* Twitter
* Instagram
* InstagramComments
* Facebook
* FacebookComments
* YouTube
* YouTubeComments
* News
* Blogs
* Linkedin
* Tiktok

### References

* [API Stilingue](https://help.blip.ai/hc/pt-br/articles/17886122640279-API-STILINGUE)
* [API Docs](https://docs-stilingue.blip.ai)
  * [Authentication](https://docs-stilingue.blip.ai/#autenticacao)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/stilingue.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.