Blog e knowledge base del servizio

Invio di un adesivo nel bot di Telegram

Messaggio animato su Telegram - un formato visivo unico per la comunicazione emotiva in Telegram. Gli adesivi sono immagini statiche (WEBP) o animate (TGS) ottimizzate per l'invio rapido e la riproduzione automatica. Non supportano il testo, ma possono essere accompagnati da pulsanti cliccabili. Ogni adesivo appartiene a un set specifico (pack) creato tramite @StickersBot, che garantisce la coerenza del design.

Invio di un adesivo nel bot di Telegram

Quali formati accetta l'adesivo in Telegram e quali sono le restrizioni?

Per diversi tipi di adesivi, Telegram ha diversi formati di immagine:

  1. PNG. Adatto per adesivi statici. Il formato offre immagini di alta qualità e uno sfondo trasparente. La dimensione dell'adesivo è 512×512 pixel. 
  2. WEBP. Formato per adesivi animati. Consente di creare animazioni creative e pittoriche. Anche la dimensione dell'adesivo è 512×512 pixel.
  3. TGS. Formato speciale Telegram per adesivi animati. La durata dell'animazione non può superare i 3 secondi, la frequenza dei fotogrammi è di 30 o 60 FPS. La dimensione della tela è 512×512 pixel. 


Alcune limitazioni:

1. Autorizzazione: 

  - Minuto.: 100×100 px, 

  - Max.: 512 × 512 px (consigliato 512×512 per chiarezza). 

2. Trasparenza: Obbligatorio (lo sfondo viene rimosso automaticamente). 

3. Anteprima: L'anteprima quadrata viene generata automaticamente

4. Animazione: 

  - Solo TGS (formato Telegram), 

  - MAX. durata: 3 secondi, 

  - Max. frame rate: 60 FPS

Errori popolari durante l'invio di adesivi

400 Richiesta errata: STICKER_PNG_NOPNG

- Motivo: PNG inviato invece di WEBP / TGS. 

- Soluzione: Converti in WEBP: 

400 Richiesta errata: STICKER_TGS_NOTGS

- Motivo: file TGS non valido. 

- Soluzione: controlla l'animazione tramite [tgsviewer] (https://www.tgsviewer.com/).

400 Richiesta non valida: Emoji adesivi non validi

- Motivo: quando si crea un set, vengono specificate Emoji inesistenti. 

- Soluzione: usa solo emoji standard(✅: 😊, ❤️, ⭐️). 

400 Richiesta errata: nome del set di adesivi non valido

- Motivo: il nome del set contiene caratteri vietati. 

- Soluzione: Usa caratteri latini e underscore: my_cool_pack. 

403 Forbidden: Bot non è un proprietario di set di adesivi

- Soluzione: Crea Set solo tramite l'account che ha creato gli adesivi. 

Informazione

Informazioni tecniche per»API BOT-MARKET"

  1. - Codice del tipo di messaggio (`messageType`): "10" (per`sendSticker'). 
  2. - Max. velocità di invio: 30 adesivi / secondo (a causa del peso ridotto dei file). 
  3. - Limiti di set:

    - Statici: fino a 120 adesivi per confezione, 

    - Animato: fino a 50 adesivi per confezione. 

Suggerimenti per un uso efficace

1. Regole di progettazione: 

  - Contorno: 2-3 px tratto per il contrasto su qualsiasi sfondo. 

  - Dimensioni: 512×512 px con trasparenza → Telegram si ridimensiona a 100-200 px nella chat.

2. Promozione dei set: 

  - Aggiungi un pulsante sotto l'adesivo