TELEGRAM Con Sunco

Creazione di un Bot

I bot di Telegram sono utenti virtuali a cui possono essere connessi sistemi terzi come Zendesk.

Questi bot funzionano all'interno di Telegram.

Questo esempio utilizza BotFather per creare un bot e i token di accesso, e poi utilizza quel bot per inviare messaggi da Telegram a Sunshine Conversations.

Per maggiori informazioni sui bot di Telegram, consulta Bot: un'introduzione per sviluppatori.

Per creare un bot

1. Apri la tua applicazione Telegram o vai alla versione per browser web all'indirizzo https://web.telegram.org/z/

2. Cerca @BotFather e avvia una chat con il bot.

3. Nella finestra della chat, digita /newbot e segui le istruzioni sullo schermo.

4. Quando hai creato con successo un bot, BotFather visualizza un messaggio “Done! Congratulations on your new bot.” (Fatto! Congratulazioni per il tuo nuovo bot.).

5. Copia il token sicuro da quel messaggio.

6. Zendesk utilizza quel token sicuro per integrarsi con Telegram.

Creare integrazione con Zendesk

Andare in admin Zendesk e creare una chiave di API COnversation:

.../admin/apps-integrations/apis/conversations-api

Cliccare su "Crea Chiavi API" e assegnare un nome alla chiave (ESempio Telegram).

Comparirà una finestra tipo questa:

Copiarsi i tre valori visualizzati (soprattutto la chiave segreta che NON sarà più visualizzabile)

A questo punto usando Postman esegui queste chiamate:

Farai una richiesta POST all'endpoint dell'API di Sunshine Conversations per creare integrazioni.

• Endpoint API: https://api.smooch.io/v2/apps/{IdApp}/integrations

• Metodo HTTP: POST

• Autenticazione: Basic Auth usando il tuo [ID Chiave] come username e la [chiave Segreta] come password.

• Intestazioni (Headers):

  • Content-Type: application/json

Corpo della Richiesta (JSON):

{
"type": "telegram",
"token": "IL_TUO_TOKEN_API_DEL_BOT_TELEGRAM",
"displayName": "Mio Canale Supporto Telegram" // Opzionale, ma utile per l'identificazione

}

Risposta di Successo:

In caso di successo, l'API risponderà con uno stato 201 Created e un oggetto JSON che rappresenta l'integrazione Telegram appena creata, incluso il suo id.

{
"integration": {
"id": "stringa_id_integrazione", // ad es. 65f1a2b3c4d5e6f7a8b9c0d1
"type": "telegram",
"status": "active", // o "inactive" inizialmente, potrebbe volerci un momento per confermare
"displayName": "Integrazione Telegram via API",
"token": "IL_TUO_TOKEN_API_DEL_BOT_TELEGRAM" // Il token di solito viene restituito
// ... altre proprietà
}
}

Passaggio 4: Verifica e Test

1. Invia un Messaggio: Apri Telegram, trova il tuo bot e inviagli un messaggio.

2. Controlla Zendesk: Un nuovo ticket dovrebbe essere creato nella tua istanza Zendesk Support da quel messaggio Telegram.

3. Rispondi da Zendesk: Rispondi al ticket in Zendesk. La risposta dovrebbe tornare all'utente su Telegram.

Riferimento:

https://docs.smooch.io/guide/telegram/