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

# Gruppi WhatsApp

> La base di Switchbord per le conversazioni della Meta Groups API e i pilot di gruppi interni al team.

# Gruppi WhatsApp

Switchbord include ora la prima base per le conversazioni di gruppo WhatsApp. La casella di posta può contrassegnare le conversazioni come gruppi, mostrare riepiloghi dei gruppi e filtrare l'elenco delle conversazioni per **Gruppi** ai fini di test interni al team.

<Info>
  Questo è un livello di base. Non offre ancora la gestione completa del ciclo di vita del gruppo, la gestione dei partecipanti o l'applicazione completa dei vincoli sull'invio ai gruppi.
</Info>

## Vincoli della Meta Groups API

La Groups API di Meta ha vincoli diversi rispetto alla normale messaggistica uno-a-uno della Cloud API:

* Le aziende devono disporre di un **Official Business Account (OBA)** per usare le funzionalità della Groups API.
* I gruppi sono solo su invito e i partecipanti si uniscono tramite un link di invito al gruppo.
* Numero massimo di partecipanti al gruppo: **8**.
* I tipi di messaggio supportati includono testo, media, modelli basati su testo e modelli basati su media.
* Le esperienze non supportate includono la Calling API, i messaggi effimeri, i messaggi a visualizzazione unica, i messaggi di autenticazione, i messaggi di commercio e i messaggi interattivi.
* Le analitiche dei modelli non sono disponibili per i modelli usati nei gruppi; crea modelli separati per l'uso nei gruppi.

## Supporto attuale di Switchbord

La base della v0.15.53 aggiunge:

* Riepiloghi di dominio `Conversation.isGroup` e `Conversation.group`.
* Rilevamento dei gruppi basato sui metadati da `conversations.metadata` (`chatType`, `conversationType`, `type`, o `isGroup`).
* Un filtro a pillola "solo Gruppi" in `/inbox` accanto ai filtri esistenti dell'elenco conversazioni.
* Supporto lato server per `groupsOnly=1` su `/api/inbox/conversations`.
* Un indice sui metadati Supabase per l'individuazione delle conversazioni di gruppo.
* Dati mock di gruppo interni al team per test QA iniziali.

## Struttura consigliata dei metadati

Fino a quando non sarà disponibile una tabella dedicata per i gruppi, le conversazioni di gruppo dovrebbero avere metadati simili a:

```json theme={null}
{
  "chatType": "group",
  "groupId": "120363012345678901@g.us",
  "groupName": "Internal Team · May arrivals",
  "participantCount": 6
}
```

Evita di restituire link di invito nelle risposte generiche dell'elenco della casella di posta, a meno che l'azione dell'operatore non ne abbia specificamente bisogno.

## Limitazioni attuali

* La casella di posta può filtrare e identificare i gruppi, ma il riquadro di dettaglio selezionato necessita ancora di una rifinitura della presentazione orientata ai gruppi.
* I vincoli specifici sull'invio ai gruppi non sono ancora completamente applicati.
* La gestione dell'elenco dei partecipanti non è implementata.
* La creazione/aggiornamento del link di invito non è implementata.
* I modelli e le analitiche dei gruppi dovrebbero essere separati dai modelli di campagna uno-a-uno.

## Elenco di implementazione di follow-up

1. Evidenziare il nome del gruppo, l'id del gruppo e il conteggio dei partecipanti nella riga dell'elenco, nell'intestazione e nel riquadro di dettaglio laterale.
2. Aggiungere protezioni specifiche per l'invio ai gruppi per i tipi di messaggio non supportati.
3. Aggiungere l'importazione/sincronizzazione dei gruppi dalla Meta Groups API una volta confermata l'idoneità OBA.
4. Aggiungere la gestione dei partecipanti e le azioni sui link di invito dietro permessi espliciti.
5. Aggiungere test con il gruppo interno al team come primo target QA in produzione.