> ## 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.

# WhatsApp Business

> Invia messaggi e template ai clienti, ricevi messaggi in Arya.

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

## Cosa fa

Integrazione con WhatsApp Business API per comunicazione commerciale. Richiede numero WhatsApp Business verificato e template approvati da Meta per messaggi outbound.

## Prerequisiti

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

## Collega WhatsApp Business

<Steps>
  <Step title="Vai a Impostazioni → Integrazioni">Cerca **WhatsApp Business** nella galleria e click **Connetti**.</Step>
  <Step title="Autorizza via OAuth">Ti apre la pagina di login di WhatsApp 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 → \[WhatsApp Business] → Configura**.</Step>
</Steps>

## Cosa sincronizza

| Direzione       | Entità                             |
| --------------- | ---------------------------------- |
| Arya → WhatsApp | Invio messaggi e template          |
| WhatsApp → Arya | Risposte cliente nella timeline    |
| Opt-in          | Gestione consensi nella conformità |

## Uso nei workflow

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

* Triggerare workflow da eventi WhatsApp Business
* Usare WhatsApp 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 WhatsApp Business.</Step>
  <Step title="Click Disconnetti">Conferma. L'access token viene revocato.</Step>
</Steps>
