Verdent Docs
Funzionalità principali

Messaggistica istantanea

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

PiattaformaTipo
TelegramBot personale
SlackBot per workspace
FeishuBot 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

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

Apri Aggiungi canale

Nella barra laterale sinistra di Manager, seleziona il pulsante + in alto (Aggiungi canale).

Seleziona una piattaforma

Scegli la piattaforma che vuoi connettere (Telegram, Slack o Feishu).

Segui i passaggi guidati

Completa la configurazione in due fasi nel pannello laterale.


Configurazione di Telegram

Fase 1: crea il Bot e ottieni il token

Scrivi a BotFather

Cerca @BotFather su Telegram e invia /newbot.

Assegna un nome al bot

Segui le istruzioni per fornire un nome visualizzato e un username.

Copia il token

Dopo la creazione, BotFather restituisce un token nella forma 123456:ABC-DEF1234....

Incolla in Verdent

Incolla il token nel campo Bot Token del pannello di configurazione di Verdent e conferma.

Fase 2: abbinamento tramite messaggio

Invia un messaggio

Apri il nuovo bot in Telegram e invia un messaggio qualsiasi (per esempio hello).

Ricevi il codice di abbinamento

Il bot risponde automaticamente con un codice di abbinamento.

Conferma in Verdent

Inserisci il codice nel pannello di Verdent e conferma. La connessione è ora completa.


Configurazione di Slack

Fase 1: crea l'app Slack e ottieni i token

Crea una nuova app

Vai su api.slack.com/apps e seleziona Create New App.

Usa il manifest fornito

Scegli From an app manifest e incolla il manifest JSON fornito da Verdent (nell'interfaccia è disponibile un pulsante di copia).

Seleziona un workspace

Scegli il workspace Slack e crea l'app.

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.

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

Fase 2: abbinamento tramite messaggio

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


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

Apri la console per sviluppatori

Vai sulla Feishu Open Platform e accedi con il tuo account Feishu.

Crea un'app personalizzata

Seleziona Create Custom App nell'angolo in alto a destra.

Inserisci le informazioni di base

Inserisci il nome e la descrizione dell'app, quindi completa la creazione.

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:

{
  "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

Apri Credentials & Basic Info nel menu a sinistra:

Copia App ID e App Secret

Copia l'App ID (nella forma cli_xxx...) e l'App Secret.

Incolla in Verdent

Incolla entrambi i valori nei campi corrispondenti del pannello di configurazione di Verdent.

Connetti

Seleziona Connect per completare la prima fase.

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

Sempre nella pagina Events & Callbacks:

Aggiungi l'evento dei messaggi

Seleziona Add Event, quindi cerca e aggiungi im.message.receive_v1 (evento di ricezione messaggi).

Crea e pubblica una versione

Seleziona Create and Publish Version nell'angolo in alto a destra, compila le note di versione e conferma.

Abbina con Verdent

Dopo la pubblicazione, torna su Verdent e invia un messaggio al tuo bot Feishu per completare l'abbinamento.

Cosa fa ciascun permesso

PermessoScopo
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:resourceLegge 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:readonlyLegge i contenuti di Feishu Docs e Wiki, così i link ai documenti possono essere passati a Manager come contesto
application:application:self_manageGestisce la configurazione della stessa app; necessario per la funzionalità di connessione persistente

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

  • 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

Centro di comando mobile

Mentre sei in movimento, di' al bot su Telegram: "Distribuisci le ultime modifiche del branch main su staging." Quando torni, il risultato è pronto.

Collaborazione di team

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.

Cattura rapida delle idee

Prima di dormire, invia un'idea al bot e chiedi a Manager di trasformarla in un'attività da eseguire l'indomani.