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

# Inviare Messaggi dentro a Gruppi WhatsApp

> Come inviare messaggi ai gruppi WhatsApp tramite Trilly usando ID Gruppo, formattazione numero e API correlate.

# Inviare Messaggi dentro a Gruppi WhatsApp

Trilly consente non solo di inviare messaggi ai singoli numeri di telefono, ma anche direttamente **all’interno dei Gruppi WhatsApp**, sfruttando l’ID univoco del gruppo.

👉 **Guida completa ufficiale:**\
[https://trilly.chat/scrivere-messaggi-in-un-gruppo-whatsapp-usando-trilly/](https://trilly.chat/scrivere-messaggi-in-un-gruppo-whatsapp-usando-trilly/)

***

## 🔎 Come funzionano i messaggi verso i Gruppi WhatsApp

Per inviare un messaggio dentro a un gruppo WhatsApp, è necessario utilizzare il **Group ID**, che viene utilizzato al posto del numero di telefono.

Un ID Gruppo WhatsApp può presentarsi in diversi formati, ad esempio:

[120363205432159876@g.us](mailto:120363205432159876@g.us)

oppure nei nuovi formati “LID”:

1234567890123456789012\@lid

oppure semplicemente:

1234567890123456789012 (22 caratteri)

Trilly riconosce automaticamente questi formati e li tratta come **destinatari validi di gruppo**.

***

## 📌 Regola fondamentale nel formato del campo `phone`

L’ID del gruppo va passato come **stringa esattamente così com’è**, senza ulteriori modifiche o prefissi (es. +39).

Il sistema lo riconosce grazie alle regole presenti.

### Esempi accettati:

[120363205432159876@g.us](mailto:120363205432159876@g.us)
1234567890123456789012
393874923874\@lid

Se il valore rispetta uno di questi formati, Trilly **non applica alcuna normalizzazione** e utilizza direttamente l’ID per l'invio.

***

## 🚀 Invio di un messaggio verso un gruppo con Sequenza Standard

L’invio avviene tramite:

```http theme={null}
POST /api/start/{id_sequenza}?api_key=API_KEY

{
  "phone": "120363205432159876@g.us",
  "text": "Ciao gruppo! Questo è un messaggio inviato da Trilly 🎉"
}


## La risposta contiene l’ID pubblico del messaggio:
{
  "id": ["MSG_123456789"]
}
```


## OpenAPI

````yaml POST /api/start/{id_sequenza}
openapi: 3.1.0
info:
  title: Trilly API
  description: Trilly APIs
  version: 1.0.0
servers:
  - url: https://backend.trilly.chat
security: []
paths:
  /api/start/{id_sequenza}:
    post:
      summary: Invio Messaggio Standard (interno a Sequenza Standard)
      description: >-
        Questa chiamata consente di attivare all’interno di Trilly una sequenza
        di messaggi WhatsApp verso un unico numero di telefono destinatario. La
        sequenza può essere costituita da 1 solo messaggio oppure da più
        messaggi. All’interno della struttura verrà inserito il campo
        parametrico del numero di telefono verso cui punterà la sequenza, con
        eventuale corredo di una serie di ulteriori campi parametrici, che
        potranno essere stringhe di testo da includere all’interno del copy del
        messaggio; un url di un file multimediale disponibile online (caricato
        in FTP) che potrà essere utilizzato come allegato multimediale (dovrà
        presentare estensioni ammesse); oppure uno più riferimenti temporali
        (data/ora) che potranno regolare il timing di invio di uno o più
        messaggi inclusi nella sequenza. Ogni singolo messaggio interno alla
        sequenza potrà avere come criterio temporale la chiamata API (con
        eventuale delay), oppure un anticipo o un delay rispetto ad un
        riferimento temporale (data/ora) che dovrà essere trasmesso nei campi
        parametrici. Alla ricezione della chiamata, Trilly programmerà in unica
        soluzione l’invio dei messaggi previsti all’interno della sequenza.
        Verranno restituiti gli ID univoci di tutti i messaggi programmati.
      parameters:
        - name: id_sequenza
          in: path
          required: true
          schema:
            type: string
          description: L'id della sequenza.
        - name: api_key
          in: query
          schema:
            type: string
          description: L'ApiKey dell'utente.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                phone:
                  type: string
                  description: Numero di telefono a cui si vuole scrivere.
                text:
                  type: string
                  description: Testo del messaggio.
                media:
                  type: string
                  description: Url del contenuto multimediale che si vuole allegare.
                media_name:
                  type: string
                  description: >-
                    Nome che si vuole compaia sotto a miniatura di eventuale
                    PDF.
              required:
                - phone
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: array
                    items:
                      type: string
                    description: ID dei messaggi generati.
                  daily_api_cap:
                    type: integer
                    description: Numero massimo di chiamate API giornaliere effettuabili.
                  daily_api_used:
                    type: integer
                    description: Numero di chiamate API giornaliere utilizzate.
                  daily_api_remaining:
                    type: integer
                    description: Numero di chiamate API giornaliere rimanenti.
              example:
                id:
                  - ID_MESSAGGIO_GENERATO
                daily_api_cap: 500
                daily_api_used: 5
                daily_api_remaining: 495

````