> For the complete documentation index, see [llms.txt](https://docs.omnileads.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnileads.net/english/instagram-settings/instagram-integration.md).

# Instagram integration

ABefore integrating Meta Messenger with OMniLeads, you need an active Meta Business Manager account and an app configured for the service.

The following are the general and recommended steps to complete the registration process from the official Meta environment:

#### 1. Access to Meta Business Manager

* Access [https://business.facebook.com](https://business.facebook.com/)
* If you already have a Business Manager, simply log in. If you don't have one yet, create your business account by providing your company name, email address, and website.

#### 2. Business Verification

* It's always important to verify the business that will be using the channel to ensure compliance with the Service Usage Policies. Go to Business Settings and complete the business identity verification process.

Meta will request official documents that prove the existence of the business (CUIT, tax registration, company name, etc.). This step is essential for a proper verification process.

<figure><img src="https://1083123978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qGfc9c0eCArZb6QcwvW%2Fuploads%2Fp6ekWP7A7NnG191oNC78%2Fimage.png?alt=media&amp;token=52c10c49-1eeb-4834-8b98-eda84a897814" alt=""><figcaption></figcaption></figure>

#### 3. Application Creation

Below are a series of steps in the Wizard to use the Instagram Messenger API (as well as other channels).

Since Meta may change the registration procedure without prior notice, it is important to visit the manufacturer's website and delve into the details of the process: <https://developers.facebook.com/documentation/business-messaging/instagram-messaging>.

* Once inside the panel of [Meta for Developers](https://developers.facebook.com/), Go to the “My Apps” section and select Create New App (if you already have one, you can skip the rest of the steps and go directly to Step 4).

<figure><img src="https://1083123978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qGfc9c0eCArZb6QcwvW%2Fuploads%2FHTk77vSHsZUKcQEjSuPH%2Fimage.png?alt=media&amp;token=11735bc9-ae83-4b57-a134-95474bbbb3ee" alt=""><figcaption></figcaption></figure>

* Follow the App Creation Wizard, completing the required information at each step of the form.

<figure><img src="https://1083123978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qGfc9c0eCArZb6QcwvW%2Fuploads%2F64uIlpofUqBk55Wcj49k%2Fimage.png?alt=media&amp;token=f8258b8f-0e92-48bf-bc95-f3226e665bfa" alt=""><figcaption></figcaption></figure>

* In Use Cases, select "Other," and in App Type, select "Business." In this final part of the Wizard, you can connect your app to the business portfolio and grant certain application-level permissions for using the Meta API.

<figure><img src="https://1083123978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qGfc9c0eCArZb6QcwvW%2Fuploads%2FfO0aTrNEdUD9KsH5o3jk%2Fimage.png?alt=media&amp;token=1f67caae-d5bc-4c13-a1d7-afd75d5a1457" alt=""><figcaption></figcaption></figure>

* Once the app has been created, select Instagram from the list of available products and click Configure.

<figure><img src="https://1083123978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qGfc9c0eCArZb6QcwvW%2Fuploads%2FhLoIN5IzwH38i23upM5M%2Fimage.png?alt=media&amp;token=8088948e-1c59-470c-ba5e-019162de3523" alt=""><figcaption></figcaption></figure>

4. Webhook Configuration

* In the Messenger API Configuration section, we define the webhook or web service that will be used in OMniLeads, respecting the following format:

`https://my_omnileads/webhook/instagram/<AppID>/`\
&#x20;\
&#x20;Where my\_omnileads is the instance hosting the OMniLeads platform, and AppID is the identifier of the app created in Meta Developers. Remember that the digital certificates used for HTTPS must be valid, and the domain name or FQDN (Fully Qualified Domain Name) must be reachable on the internet.\
\
From the Instagram menu -> API Settings, you must add the Instagram business account you intend to integrate with, as well as generate an access token that will be used to configure OMniLeads.\
On the other hand, the secret key will help protect your webhook, so it's necessary to set one and rotate it periodically.

<figure><img src="https://1083123978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qGfc9c0eCArZb6QcwvW%2Fuploads%2FwnbnpuClZkBwOvlPbiU7%2Fimagen.png?alt=media&amp;token=5735a407-ea8f-410c-b3c3-fc5ca0905932" alt=""><figcaption></figcaption></figure>

#### 5. Event Subscription:

Below is a list of the events to which the webhook must subscribe for proper operation with OMniLeads

<figure><img src="https://1083123978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qGfc9c0eCArZb6QcwvW%2Fuploads%2FWAOzPrYJflwcsoaGwkgw%2Fimagen.png?alt=media&amp;token=da8f1261-1956-49c6-b774-8fd7880b5f5d" alt=""><figcaption></figcaption></figure>

#### Done!

We are now ready to configure the settings from the OMniLeads app. To do this, from the menu “Connections → Meta/Facebook → Instagram”, we will configure a new resource to interact with Instagram.

For more details, visit the section [Cuentas de Instagram](broken://pages/nNbFBSg3rp7WhK1y0xnW).


---

# 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://docs.omnileads.net/english/instagram-settings/instagram-integration.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.
