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

# Invio Messaggio Standard

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



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

````