Skip to main content
POST
/
api
/
start
/
{id_sequenza}
Invio Messaggio Standard (interno a Sequenza Standard)
curl --request POST \
  --url https://backend.trilly.chat/api/start/{id_sequenza} \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "<string>",
  "text": "<string>",
  "media": "<string>",
  "media_name": "<string>"
}
'
{
  "id": [
    "ID_MESSAGGIO_GENERATO"
  ],
  "daily_api_cap": 500,
  "daily_api_used": 5,
  "daily_api_remaining": 495
}

​
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/

​
🔎 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 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 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: 
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"]
}

Path Parameters

​
id_sequenza
string
required

L'id della sequenza.

Query Parameters

​
api_key
string

L'ApiKey dell'utente.

Body

application/json
​
phone
string
required

Numero di telefono a cui si vuole scrivere.

​
text
string

Testo del messaggio.

​
media
string

Url del contenuto multimediale che si vuole allegare.

​
media_name
string

Nome che si vuole compaia sotto a miniatura di eventuale PDF.

Response

200 - application/json

OK

​
id
string[]

ID dei messaggi generati.

​
daily_api_cap
integer

Numero massimo di chiamate API giornaliere effettuabili.

​
daily_api_used
integer

Numero di chiamate API giornaliere utilizzate.

​
daily_api_remaining
integer

Numero di chiamate API giornaliere rimanenti.