# Messaggistica istantanea (/it/docs/verdent-manager/core-features/instant-messaging)

> Assegna attività a Manager da Telegram, Slack o Feishu



Non è necessario essere al computer per assegnare attività a Manager. Collegando Telegram, Slack o Feishu, puoi inviare messaggi a Manager in qualsiasi momento e ovunque usando strumenti di chat che già conosci. Manager trasforma i tuoi messaggi in attività strutturate e inizia a eseguirle: cattura un'idea mentre scorri sul telefono e torna più tardi per vedere il risultato.

## Piattaforme di messaggistica istantanea supportate [#piattaforme-di-messaggistica-istantanea-supportate]

| Piattaforma | Tipo              |
| ----------- | ----------------- |
| Telegram    | Bot personale     |
| Slack       | Bot per workspace |
| Feishu      | Bot aziendale     |

Ogni piattaforma richiede la creazione di un Bot nella relativa console per sviluppatori, per poi completare l'abbinamento in Verdent. Una volta connesso, qualsiasi messaggio inviato al Bot viene inoltrato direttamente a Manager.

***

## Flusso di connessione [#flusso-di-connessione]

Il processo di connessione prevede due fasi:

1. **Inserisci il token** — configurazione delle credenziali
2. **Invia un messaggio per l'abbinamento** — collega il Bot a Manager

Tutto viene configurato nella pagina delle impostazioni del canale, nella barra laterale di Manager.

### Come accedere alla configurazione [#come-accedere-alla-configurazione]

<Steps>
  <Step title="Apri Aggiungi canale">
    Nella barra laterale sinistra di Manager, seleziona il pulsante &#x2A;*+** in alto (Aggiungi canale).
  </Step>

  <Step title="Seleziona una piattaforma">
    Scegli la piattaforma che vuoi connettere (Telegram, Slack o Feishu).
  </Step>

  <Step title="Segui i passaggi guidati">
    Completa la configurazione in due fasi nel pannello laterale.
  </Step>
</Steps>

***

## Configurazione di Telegram [#configurazione-di-telegram]

### Fase 1: crea il Bot e ottieni il token [#fase-1-crea-il-bot-e-ottieni-il-token]

<Steps>
  <Step title="Scrivi a BotFather">
    Cerca [@BotFather](https://t.me/BotFather) su Telegram e invia `/newbot`.
  </Step>

  <Step title="Assegna un nome al bot">
    Segui le istruzioni per fornire un nome visualizzato e un username.
  </Step>

  <Step title="Copia il token">
    Dopo la creazione, BotFather restituisce un token nella forma `123456:ABC-DEF1234...`.
  </Step>

  <Step title="Incolla in Verdent">
    Incolla il token nel campo **Bot Token** del pannello di configurazione di Verdent e conferma.
  </Step>
</Steps>

### Fase 2: abbinamento tramite messaggio [#fase-2-abbinamento-tramite-messaggio]

<Steps>
  <Step title="Invia un messaggio">
    Apri il nuovo bot in Telegram e invia un messaggio qualsiasi (per esempio `hello`).
  </Step>

  <Step title="Ricevi il codice di abbinamento">
    Il bot risponde automaticamente con un codice di abbinamento.
  </Step>

  <Step title="Conferma in Verdent">
    Inserisci il codice nel pannello di Verdent e conferma. La connessione è ora completa.
  </Step>
</Steps>

***

## Configurazione di Slack [#configurazione-di-slack]

### Fase 1: crea l'app Slack e ottieni i token [#fase-1-crea-lapp-slack-e-ottieni-i-token]

<Steps>
  <Step title="Crea una nuova app">
    Vai su [api.slack.com/apps](https://api.slack.com/apps) e seleziona **Create New App**.
  </Step>

  <Step title="Usa il manifest fornito">
    Scegli **From an app manifest** e incolla il manifest JSON fornito da Verdent (nell'interfaccia è disponibile un pulsante di copia).
  </Step>

  <Step title="Seleziona un workspace">
    Scegli il workspace Slack e crea l'app.
  </Step>

  <Step title="Copia entrambi i token">
    Nelle impostazioni dell'app, individua il **Bot Token** (`xoxb-`) e l'**App Token** (`xapp-`), quindi incolla entrambi nel pannello di configurazione di Verdent.
  </Step>
</Steps>

<Note>
  **Requisito per il nome dell'app:** il nome deve avere meno di 80 caratteri e non può contenere caratteri cinesi, giapponesi o coreani.
</Note>

### Fase 2: abbinamento tramite messaggio [#fase-2-abbinamento-tramite-messaggio-1]

Come per Telegram: invia un messaggio al bot, ricevi il codice di abbinamento e inseriscilo in Verdent per completare la connessione.

***

## Configurazione di Feishu [#configurazione-di-feishu]

Feishu richiede qualche passaggio in più rispetto a Telegram o Slack: i permessi si configurano separatamente e gli eventi vanno sottoscritti manualmente. Non è complesso, ma ogni passaggio deve essere eseguito correttamente, altrimenti la connessione si blocca. Segui i passaggi nell'ordine indicato.

### Passaggio 1: crea un'app personalizzata [#passaggio-1-crea-unapp-personalizzata]

<Steps>
  <Step title="Apri la console per sviluppatori">
    Vai sulla [Feishu Open Platform](https://open.feishu.cn/app) e accedi con il tuo account Feishu.
  </Step>

  <Step title="Crea un'app personalizzata">
    Seleziona **Create Custom App** nell'angolo in alto a destra.
  </Step>

  <Step title="Inserisci le informazioni di base">
    Inserisci il nome e la descrizione dell'app, quindi completa la creazione.
  </Step>
</Steps>

### Passaggio 2: configura i permessi [#passaggio-2-configura-i-permessi]

Apri la nuova app e vai su **Permissions & Scopes** nel menu a sinistra.

Feishu supporta l'importazione in blocco degli scope, quindi non devi selezionarli uno per uno. Individua nella pagina la funzione di importazione/esportazione in blocco e incolla per intero il seguente JSON:

```json
{
  "scopes": {
    "tenant": [
      "im:message:send_as_bot",
      "im:message",
      "im:resource",
      "im:chat",
      "im:chat:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "wiki:wiki:readonly",
      "application:application:self_manage"
    ],
    "user": []
  }
}
```

Dopo aver confermato l'importazione, tutti gli scope sopra elencati dovrebbero comparire come selezionati nell'elenco dei permessi.

### Passaggio 3: ottieni le credenziali e connetti Verdent [#passaggio-3-ottieni-le-credenziali-e-connetti-verdent]

Apri **Credentials & Basic Info** nel menu a sinistra:

<Steps>
  <Step title="Copia App ID e App Secret">
    Copia l'**App ID** (nella forma `cli_xxx...`) e l'**App Secret**.
  </Step>

  <Step title="Incolla in Verdent">
    Incolla entrambi i valori nei campi corrispondenti del pannello di configurazione di Verdent.
  </Step>

  <Step title="Connetti">
    Seleziona **Connect** per completare la prima fase.
  </Step>
</Steps>

### Passaggio 4: abilita la connessione persistente [#passaggio-4-abilita-la-connessione-persistente]

Una volta connesso, torna alla Feishu Open Platform e apri **Events & Callbacks**.

Attiva **Use Long Connection to Receive Events**. Questa opzione controlla il modo in cui Feishu consegna i messaggi al bot: la connessione persistente non richiede di esporre un URL pubblico, ma mantiene invece una connessione permanente, il che risulta più affidabile.

### Passaggio 5: sottoscrivi gli eventi dei messaggi e pubblica [#passaggio-5-sottoscrivi-gli-eventi-dei-messaggi-e-pubblica]

Sempre nella pagina **Events & Callbacks**:

<Steps>
  <Step title="Aggiungi l'evento dei messaggi">
    Seleziona **Add Event**, quindi cerca e aggiungi `im.message.receive_v1` (evento di ricezione messaggi).
  </Step>

  <Step title="Crea e pubblica una versione">
    Seleziona **Create and Publish Version** nell'angolo in alto a destra, compila le note di versione e conferma.
  </Step>

  <Step title="Abbina con Verdent">
    Dopo la pubblicazione, torna su Verdent e invia un messaggio al tuo bot Feishu per completare l'abbinamento.
  </Step>
</Steps>

### Cosa fa ciascun permesso [#cosa-fa-ciascun-permesso]

| Permesso                                            | Scopo                                                                                                            |
| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Famiglia `im:message:*`                             | Consente al bot di leggere e inviare messaggi, inclusi messaggi diretti e menzioni @ nei gruppi                  |
| `im:chat:*`                                         | Legge l'elenco delle conversazioni a cui appartiene il bot                                                       |
| `im:resource`                                       | Legge immagini, file e altre risorse allegate ai messaggi                                                        |
| `contact:*`                                         | Legge le informazioni di contatto di base per identificare chi ha inviato un messaggio                           |
| `docs:document.content:read` / `wiki:wiki:readonly` | Legge i contenuti di Feishu Docs e Wiki, così i link ai documenti possono essere passati a Manager come contesto |
| `application:application:self_manage`               | Gestisce la configurazione della stessa app; necessario per la funzionalità di connessione persistente           |

***

## Dopo la connessione riuscita [#dopo-la-connessione-riuscita]

Una volta abbinato, il canale compare nell'elenco dei canali nella barra laterale sinistra di Manager e mostra:

* Icona della piattaforma e nome del canale
* Stato della connessione (**Connected** / **Disconnected** / **Needs attention**)
* Anteprima e marca temporale dell'ultimo messaggio
* Indicatore di messaggi non letti (punto verde)

Da questo momento in poi, ogni messaggio inviato al Bot viene gestito direttamente da Manager come attività eseguibile.

***

## Gestione dei canali connessi [#gestione-dei-canali-connessi]

* **Visualizza tutti i canali** — tutti i canali IM connessi sono elencati nella barra laterale.
* **Elimina un canale** — passa il puntatore su un canale, seleziona elimina e conferma. Se è l'ultimo canale di quel tipo, viene cancellata anche la configurazione del bot.
* **Riconnetti** — se un canale mostra **Disconnected** o **Needs attention**, in alto compare un messaggio di riparazione per riconfigurarlo.

***

## Casi d'uso [#casi-duso]

<CardGroup cols="3">
  <Card title="Centro di comando mobile" icon="mobile">
    Mentre sei in movimento, di' al bot su Telegram: "Distribuisci le ultime modifiche del branch main su staging." Quando torni, il risultato è pronto.
  </Card>

  <Card title="Collaborazione di team" icon="users">
    Menziona il tuo bot Manager in un canale Slack per riassumere lo stato dei PR di oggi: le risposte compaiono direttamente nel canale, visibili a tutto il team.
  </Card>

  <Card title="Cattura rapida delle idee" icon="lightbulb">
    Prima di dormire, invia un'idea al bot e chiedi a Manager di trasformarla in un'attività da eseguire l'indomani.
  </Card>
</CardGroup>