> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> First steps on Instagram: connect an account (official or unofficial) and send your first DM.

<Tip>
  From **zero to the first queued DM** in a few steps. Choose **official (Meta)** or **unofficial**. The same send routes serve both.
</Tip>

## In short

* **Official:** Meta login in the panel or shareable link; recipient = **IGSID**; **24h** window
* **Unofficial:** username and password (or link); `acceptInstagramTerms: true`; warm-up on new accounts
* In both cases you use the **same API**; only how you connect the account changes

Not sure which to pick? See [Connection modes](/en/instagram-api/como-funciona/modos-de-conexao).

## Before you start

* An **API key** (`sk_live_...` or `sk_test_...` for sandbox)
* Instance and send permissions on the key. See [Scopes](/en/instagram-api/como-funciona/escopos-api-key)
* In the examples, replace `sk_live_xxxxx` with your key

<Note>
  Just getting started? Use `sk_test_...` and check the result in the [Sandbox inbox](/en/guides/sandbox/index).
</Note>

***

<Tabs>
  <Tab title="Official connection">
    ### 1. Connect the account

    Three paths, pick what fits your integration:

    #### 1A, Via dashboard

    1. Instagram → New connection → **Official**
    2. Sign in with Meta (or paste manual credentials on the draft)
    3. When status is **active**, note the **instance id**

    #### 1B, API with a client link

    ```http theme={null}
    POST /v1/instagram/instances
    Content-Type: application/json
    Authorization: Bearer sk_live_xxxxx
    ```

    ```json theme={null}
    {
      "name": "Atendimento IG",
      "mode": "OFFICIAL",
      "generateShareableLink": true
    }
    ```

    Expected response: **200** with **PENDING** instance and the link:

    ```json theme={null}
    {
      "success": true,
      "data": {
        "instance": {
          "id": "clxx123...",
          "name": "Atendimento IG",
          "status": "PENDING",
          "mode": "OFFICIAL"
        },
        "shareableLink": {
          "hostedUrl": "https://api.notifique.dev/w/instance-connect/...?token=...",
          "embedUrl": "https://api.notifique.dev/w/embed/instance-connect/...?token=..."
        }
      }
    }
    ```

    Send `shareableLink.hostedUrl` to the client. On the page they see **Continue with Meta**. When done, the instance becomes **ACTIVE**.

    <Warning>
      Anyone with the link can connect or disconnect the instance. After use, rotate the secret if available in the connect-page API.
    </Warning>

    #### 1C, API with Meta credentials

    **Embedded** (after Facebook Login in the browser):

    ```json theme={null}
    {
      "name": "Atendimento IG",
      "mode": "OFFICIAL",
      "metaEmbeddedCode": "CODE_DO_EMBEDDED_SIGNUP"
    }
    ```

    **BYOK** (token and IDs you already have):

    ```json theme={null}
    {
      "name": "Atendimento IG",
      "mode": "OFFICIAL_BYOK",
      "metaAccessToken": "EAAxx...",
      "facebookPageId": "123456789012345",
      "igBusinessAccountId": "17841400000000000",
      "metaAppSecret": "abc123..."
    }
    ```

    ### 2. How to get the recipient's IGSID

    In **official** mode, the `to` field uses **IGSID** (Page-scoped ID), not `@username`.

    * **Webhook** `instagram.received`: `from` field on the inbound message
    * **API** `GET /v1/instagram/messages/inbound/{id}` after the customer sends a DM
    * **Dashboard:** received message detail

    ### 3. Send the first DM

    ```http theme={null}
    POST /v1/instagram/messages
    Content-Type: application/json
    Authorization: Bearer sk_live_xxxxx
    ```

    ```json theme={null}
    {
      "instanceId": "clxx123...",
      "to": ["17841400000000000"],
      "type": "text",
      "payload": { "message": "Olá! Como posso ajudar?" }
    }
    ```

    Expected response: **202** with the message queued:

    ```json theme={null}
    {
      "success": true,
      "data": {
        "messageIds": ["msg_abc..."],
        "status": "QUEUED",
        "count": 1
      }
    }
    ```

    <Warning>
      On official, the conversation must be within the **24h window** after the customer's last message.
    </Warning>

    ### 4. After the first send

    Configure the Meta webhook at `{your_base}/webhooks/meta/instagram`, listen for `instagram.received` and send status. For comment hide, use the comments routes in the [API reference](/en/instagram-api/api-reference/api-reference).
  </Tab>

  <Tab title="Unofficial connection">
    ### 1. Connect the account

    #### 1A, Via dashboard

    1. Instagram → New connection → **Unofficial**
    2. Enter username and password (and 2FA if asked)
    3. Accept the terms; wait for **active** status

    #### 1B, API with credentials

    ```http theme={null}
    POST /v1/instagram/instances
    Content-Type: application/json
    Authorization: Bearer sk_live_xxxxx
    ```

    ```json theme={null}
    {
      "name": "Atendimento IG",
      "mode": "UNOFFICIAL",
      "acceptInstagramTerms": true,
      "auth": {
        "mode": "password",
        "username": "sua_conta",
        "password": "sua_senha"
      }
    }
    ```

    If Meta asks for verification, send `verificationCode` on create or use `POST /v1/instagram/instances/{id}/challenge/resolve`.

    #### 1C, API with a shareable link

    ```json theme={null}
    {
      "name": "Atendimento IG",
      "mode": "UNOFFICIAL",
      "acceptInstagramTerms": true,
      "generateShareableLink": true
    }
    ```

    Response: `connection.status` = `pending_login` + `shareableLink`. The client opens the link and enters username/password.

    <Warning>
      New account: read the [anti-suspension policy](/en/instagram-api/como-funciona/politica-anti-banimento) (warm-up, cooldown).
    </Warning>

    ### 2. Send the first DM

    ```json theme={null}
    {
      "instanceId": "clxx123...",
      "to": ["nome_do_usuario"],
      "type": "text",
      "payload": { "message": "Olá!" }
    }
    ```

    Expected response: **202** (same format as the official tab).

    ### 3. After the first send

    Configure workspace [webhooks](/en/instagram-api/como-funciona/eventos-do-webhooks). On unofficial you can **edit** and **unsend** sent DMs.
  </Tab>
</Tabs>

***

## All send types

In the [API reference](/en/instagram-api/api-reference/api-reference), open **Send Instagram message** (`POST /v1/instagram/messages`) and pick the example in the playground: Text, Image, Video, Audio, Document, Scheduled, official IGSID, or unofficial username.

## Next steps

* [Connection modes](/en/instagram-api/como-funciona/modos-de-conexao)
* [Webhook events](/en/instagram-api/como-funciona/eventos-do-webhooks)
* [Anti-suspension policy](/en/instagram-api/como-funciona/politica-anti-banimento)