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

# Meta Business

> Import lead da Facebook/Instagram Ads, tracking conversioni.

<Frame>
  <img src="https://mintcdn.com/agevole/cM9eEPJE8FVhTNOb/images/integrazioni/meta-business/shared/tile.svg?fit=max&auto=format&n=cM9eEPJE8FVhTNOb&q=85&s=27ddcc63f8c2625c26c50768c903ef56" alt="Tile integrazione Meta Business nelle impostazioni Arya" width="1200" height="720" data-path="images/integrazioni/meta-business/shared/tile.svg" />
</Frame>

## Cosa fa

Lead generati da campagne Lead Ads su Facebook/Instagram vengono importati automaticamente in Arya come contatti. Puoi inviare eventi di conversione (deal won) a Meta per ottimizzare le campagne.

## Prerequisiti

<Note>
  * Account attivo su Meta Business
  * Ruolo **Admin** o **Manager** su Arya per collegare l'integrazione
  * Autorizzazione OAuth (o API key, dove applicabile)
</Note>

## Collega Meta Business

<Steps>
  <Step title="Vai a Impostazioni → Integrazioni">Cerca **Meta Business** nella galleria e click **Connetti**.</Step>
  <Step title="Autorizza via OAuth">Ti apre la pagina di login di Meta Business. Concedi i permessi richiesti.</Step>
  <Step title="Conferma in Arya">Arya testa la connessione. Se ok, vedi "Connesso" in verde.</Step>
  <Step title="Configura preferenze (opzionale)">Frequenza sync, filtri, mapping campi. Da **Impostazioni → Integrazioni → \[Meta Business] → Configura**.</Step>
</Steps>

## Cosa sincronizza

| Direzione   | Entità                               |
| ----------- | ------------------------------------ |
| Meta → Arya | Lead da Lead Ads → contatti          |
| Arya → Meta | Eventi conversione (Conversions API) |
| Meta → Arya | Metriche ad → analisi ROI            |

## Uso nei workflow

Una volta collegata, Meta Business appare come azione nel [workflow builder](/it/automazioni/workflow-builder). Puoi:

* Triggerare workflow da eventi Meta Business
* Usare Meta Business come azione (es. crea record, invia messaggio)

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Errore di autorizzazione">
    Token scaduto o revocato. Disconnetti e riconnetti.
  </Accordion>

  <Accordion title="Sync lenta o fallita">
    Controlla quota API del servizio (rate limit). Riduci frequenza se superi quota.
  </Accordion>

  <Accordion title="Dati non sincronizzati">
    Verifica mapping campi e filtri. Prova sync manuale da **⋯ → Sincronizza ora**.
  </Accordion>

  <Accordion title="Errori di duplicato">
    Arya usa chiavi univoche per matching. Configura chiave (email, ID esterno) in **Impostazioni → Sync**.
  </Accordion>
</AccordionGroup>

## Disconnetti

<Warning>
  La disconnessione interrompe la sincronizzazione immediatamente. I dati già importati restano nel workspace.
</Warning>

<Steps>
  <Step title="Vai a Impostazioni → Integrazioni">Trova la card Meta Business.</Step>
  <Step title="Click Disconnetti">Conferma. L'access token viene revocato.</Step>
</Steps>