Slack
Slack è uno strumento di comunicazione del team, che riunisce tutte le comunicazioni del team in un'unica posizione, immediatamente ricercabile e disponibile ovunque ci si trovi.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - China Cloud gestito da 21Vianet |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Normale | Tutte le aree di Power Apps , ad eccezione dei seguenti: - China Cloud gestito da 21Vianet |
| Power Automate | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - China Cloud gestito da 21Vianet |
| Contatto | |
|---|---|
| Nome | Microsoft |
| URL | https://support.microsoft.com/contactus |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://slack.com/ |
| Informativa sulla privacy | https://slack.com/privacy-policy |
| Categorie | Collaborazione; Comunicazione |
Problemi noti e limitazioni
Come indicato nella documentazione dell'API Slack, alcuni metodi dell'API Slack usati dal connettore smetteranno di funzionare a febbraio 2021 e non funzioneranno con le app appena create dopo il 10 giugno 2020. Usare quindi le versioni più recenti delle azioni seguenti.
Azioni:
Creare un gruppo è deprecato. Usare la versione più recente di Creare un canale per creare canali privati.
Il numero massimo di caratteri in un messaggio è limitato a 4000. Per altre informazioni, vedere la documentazione ufficiale di Slack.
Approfondimento del connettore
Per altre informazioni sul connettore, vedere la sezione dettagliata.
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
| Frequenza dei polling dei trigger | 1 | 120 secondi |
Azioni
| Aggiungere un canale [DEPRECATO] |
Questa azione è stata deprecata. Usare invece Partecipa a un canale pubblico .
|
| Creare un canale |
Creare un canale in Slack. |
| Creare un canale [DEPRECATO] |
Questa azione è stata deprecata. Usare invece Create a channel (Crea un canale ).
|
| Creare un gruppo [DEPRECATO] |
Crea un gruppo in slack. |
| Elencare i canali [DEPRECATO] |
Questa azione è stata deprecata. Usare invece List public channels (Supporto pagination).
|
| Elencare i canali pubblici |
Elencare i canali pubblici in Slack. |
| Elencare i canali pubblici (supporto paginazione) (anteprima) |
Elencare i canali pubblici in Slack. |
| Elencare i messaggi di conversazione (anteprima) |
Elencare i messaggi pubblicati in una conversazione (canale pubblico, canale privato, messaggio diretto o messaggio diretto del gruppo). |
| Elencare le risposte ai messaggi (anteprima) |
Elencare le risposte in un thread di messaggio, incluso il messaggio padre. |
| Impostazione non disturbare |
Impostare lo stato non disturbare per l'utente. |
| Inviare un messaggio (V2) |
Questa operazione viene utilizzata per pubblicare un messaggio nel canale specificato. |
| Inviare un messaggio [DEPRECATO] |
Questa azione è stata deprecata. Usare invece Post message (V2).
|
| Ottenere il profilo utente (anteprima) |
Ottenere informazioni sul profilo per un utente slack. Utile per risolvere l'autore di un messaggio restituito da Elenca messaggi di conversazione o Elenca le risposte ai messaggi. |
| Partecipare a un canale pubblico |
Partecipare a un canale pubblico in Slack. |
Aggiungere un canale [DEPRECATO]
Questa azione è stata deprecata. Usare invece Partecipa a un canale pubblico .
Aggiungere un canale in Slack.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome
|
name | string |
Nome del canale. |
Valori restituiti
- Corpo
- JoinChannel_Response
Creare un canale
Creare un canale in Slack.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome
|
name | string |
Nome del nuovo canale. |
|
|
Canale privato?
|
is_private | boolean |
Il canale è privato o meno |
Valori restituiti
- Corpo
- CreateChannel_Response
Creare un canale [DEPRECATO]
Questa azione è stata deprecata. Usare invece Create a channel (Crea un canale ).
Creare un canale in Slack.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome
|
name | string |
Nome del nuovo canale. |
Valori restituiti
- Corpo
- CreateChannel_Response
Creare un gruppo [DEPRECATO]
Crea un gruppo in slack.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome
|
name | string |
Nome del gruppo. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
group.id | string |
ID del gruppo. |
|
Nome
|
group.name | string |
Nome del gruppo. |
Elencare i canali [DEPRECATO]
Questa azione è stata deprecata. Usare invece List public channels (Supporto pagination).
Elencare i canali in Slack.
Valori restituiti
- Corpo
- ListChannels_Response
Elencare i canali pubblici
Elencare i canali pubblici in Slack.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Tipi di conversazione
|
types | string |
Tipi di conversazione delimitati da virgole da includere. Il valore predefinito è public_channel. Includere in modo esplicito private_channel, im o mpim per elencare altri tipi di conversazione. |
|
|
Escludi archiviato
|
exclude_archived | boolean |
Impostare su true per escludere le conversazioni archiviate. |
|
|
Risultati massimi
|
limit | integer |
Numero massimo di conversazioni da restituire. |
|
|
Team Id
|
team_id | string |
ID team codificato. Obbligatorio solo per un token a livello di organizzazione. |
|
|
Cursor
|
cursor | string |
Cursore paginazione restituito dalla richiesta precedente. |
Valori restituiti
- Corpo
- ListChannels_Response
Elencare i canali pubblici (supporto paginazione) (anteprima)
Elencare i messaggi di conversazione (anteprima)
Elencare i messaggi pubblicati in una conversazione (canale pubblico, canale privato, messaggio diretto o messaggio diretto del gruppo).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID conversazione
|
channel | True | string |
Conversazione da cui recuperare i messaggi. |
|
Risultati massimi
|
limit | integer |
Numero massimo di messaggi da restituire per pagina. |
|
|
Timestamp meno recente
|
oldest | string |
Nei risultati verranno inclusi solo i messaggi dopo questo timestamp Unix. |
|
|
Timestamp più recente
|
latest | string |
Nei risultati verranno inclusi solo i messaggi prima di questo timestamp Unix. |
|
|
Conversazione completa
|
inclusive | boolean |
Includere i messaggi con i timestamp meno recenti o più recenti nei risultati. |
|
|
Includi tutti i metadati
|
include_all_metadata | boolean |
Restituisce tutti i metadati associati a ogni messaggio. |
Valori restituiti
- Corpo
- ListMessages_Response
Elencare le risposte ai messaggi (anteprima)
Elencare le risposte in un thread di messaggio, incluso il messaggio padre.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID conversazione
|
channel | True | string |
Conversazione contenente il thread. |
|
Timestamp messaggio padre
|
ts | True | string |
Timestamp del messaggio padre che avvia il thread. Disponibile come |
|
Risultati massimi
|
limit | integer |
Numero massimo di messaggi da restituire per pagina. |
|
|
Timestamp meno recente
|
oldest | string |
Nei risultati verranno inclusi solo i messaggi dopo questo timestamp Unix. |
|
|
Timestamp più recente
|
latest | string |
Nei risultati verranno inclusi solo i messaggi prima di questo timestamp Unix. |
|
|
Conversazione completa
|
inclusive | boolean |
Includere i messaggi con i timestamp meno recenti o più recenti nei risultati. |
Valori restituiti
- Corpo
- ListMessages_Response
Impostazione non disturbare
Impostare lo stato non disturbare per l'utente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero di minuti
|
num_minutes | string |
Numero di minuti da impostare non disturbare. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Snooze abilitato
|
snooze_enabled | boolean |
Indica se lo snooze è abilitato. |
Inviare un messaggio (V2)
Questa operazione viene utilizzata per pubblicare un messaggio nel canale specificato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome canale
|
channel | True | string |
Canale, gruppo privato o canale DI messaggistica istantanea a cui inviare messaggi. Può essere un nome(ad esempio: #general) o un ID codificato. |
|
Testo del messaggio
|
text | True | string |
Corpo del messaggio da inviare. L'API Slack tronca i messaggi contenenti più di 40.000 caratteri. Per le opzioni di formattazione, vedere https://api.slack.com/docs/formatting |
|
Timestamp messaggio padre
|
thread_ts | string |
Timestamp del messaggio padre durante la pubblicazione di una risposta in un thread. |
|
|
Trasmissione al canale
|
reply_broadcast | boolean |
Passare true per inviare anche una risposta threaded al canale. |
|
|
Nome bot
|
username | string |
Nome del bot. |
|
|
Pubblica come utente
|
as_user | boolean |
Passare true per pubblicare il messaggio come utente autenticato, anziché come bot. |
|
|
Modalità analisi
|
parse | string |
Modificare la modalità di trattamento dei messaggi. Per informazioni dettagliate, vedere https://api.slack.com/docs/formatting |
|
|
Analisi del markup Slack
|
mrkdwn | boolean |
Impostazione di analisi del markup slack. Abilitato per impostazione predefinita. |
|
|
Nomi dei collegamenti
|
link_names | integer |
Trovare e collegare nomi dei canali e nomi utente. |
|
|
Rimuovi collegamenti
|
unfurl_links | boolean |
Passare true per abilitare l'unfurling del contenuto principalmente basato su testo. |
|
|
Unfurl Media
|
unfurl_media | boolean |
Passare false per disabilitare l'annullamento della furling del contenuto multimediale. |
|
|
URL icona
|
icon_url | uri |
URL di un'immagine da usare come icona per questo messaggio. |
|
|
Icona Emoji
|
icon_emoji | string |
Emoji da usare come icona per questo messaggio. |
Valori restituiti
Dettagli del messaggio inviato a un canale Slack.
- Corpo
- PostMessageResponse
Inviare un messaggio [DEPRECATO]
Questa azione è stata deprecata. Usare invece Post message (V2).
Questa operazione viene utilizzata per pubblicare un messaggio nel canale specificato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome canale
|
channel | True | string |
Canale, gruppo privato o canale DI messaggistica istantanea a cui inviare messaggi. Può essere un nome(ad esempio: #general) o un ID codificato. |
|
Testo del messaggio
|
text | True | string |
Corpo del messaggio da inviare (meno di 4000 caratteri). Per le opzioni di formattazione, vedere https://api.slack.com/docs/formatting. |
|
Nome bot
|
username | string |
Nome del bot. |
|
|
Pubblica come utente
|
as_user | boolean |
Passare true per pubblicare il messaggio come utente autenticato, anziché come bot. |
|
|
Modalità analisi
|
parse | string |
Modificare la modalità di trattamento dei messaggi. Per informazioni dettagliate, vedere https://api.slack.com/docs/formatting. |
|
|
Nomi dei collegamenti
|
link_names | integer |
Trovare e collegare nomi dei canali e nomi utente. |
|
|
Rimuovi collegamenti
|
unfurl_links | boolean |
Passare true per abilitare l'unfurling del contenuto principalmente basato su testo. |
|
|
Unfurl Media
|
unfurl_media | boolean |
Passare false per disabilitare l'annullamento della furling del contenuto multimediale. |
|
|
URL icona
|
icon_url | uri |
URL di un'immagine da usare come icona per questo messaggio. |
|
|
Icona Emoji
|
icon_emoji | string |
Emoji da usare come icona per questo messaggio. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Risultato esito positivo
|
ok | boolean |
Indica se l'operazione ha avuto esito positivo. |
|
Channel
|
channel | string |
Canale a cui è stato inviato il messaggio. |
|
Creazione di Date-Time
|
ts | string |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
Testo del messaggio
|
message.text | string |
Corpo del messaggio. |
|
ID messaggio
|
message.id | string |
Identificatore univoco del messaggio. |
|
ID creatore
|
message.user | string |
Identificatore univoco dell'utente che ha pubblicato il messaggio. |
|
Ora di creazione
|
message.created | integer |
Timestamp Unix per quando viene creato il messaggio. |
|
È Eliminato
|
message.is_user-deleted | boolean |
Indica se il messaggio è stato eliminato o meno. |
|
Messaggi di errore
|
error | string |
Dettagli dei messaggi di errore, se presenti. |
Ottenere il profilo utente (anteprima)
Ottenere informazioni sul profilo per un utente slack. Utile per risolvere l'autore di un messaggio restituito da Elenca messaggi di conversazione o Elenca le risposte ai messaggi.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID utente
|
user | True | string |
ID dell'utente per cui ottenere informazioni sul profilo. |
Valori restituiti
- Corpo
- GetUserProfile_Response
Partecipare a un canale pubblico
Partecipare a un canale pubblico in Slack.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome canale
|
channel | string |
Nome del canale. |
Valori restituiti
- Corpo
- JoinChannel_ResponseV2
Trigger
| Quando viene creato un file |
Quando viene creato un file |
Quando viene creato un file
Quando viene creato un file
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Channel
|
channel | True | string |
Nome del canale. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | string |
ID del file |
|
Created
|
created | integer |
Al momento della creazione del file. |
|
Nome
|
name | string |
Nome del file. |
|
Titolo
|
title | string |
Titolo del file. |
Definizioni
Channel
Canale
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | string |
ID del canale. |
|
Nome
|
name | string |
Nome del canale. |
|
Canale pubblico
|
is_channel | boolean |
Indica se la conversazione è un canale pubblico. |
|
Canale privato
|
is_group | boolean |
Indica se la conversazione è un canale privato. |
|
Messaggio diretto
|
is_im | boolean |
Indica se la conversazione è un messaggio diretto tra due utenti. |
|
Messaggio diretto del gruppo
|
is_mpim | boolean |
Indica se questa conversazione è un messaggio diretto di gruppo. |
|
È privato
|
is_private | boolean |
Indica se la conversazione è privata. |
|
È archiviato
|
is_archived | boolean |
Indica se la conversazione è stata archiviata. |
|
Membro
|
is_member | boolean |
Indica se l'utente autenticato è membro di questa conversazione. |
|
ID utente
|
user | string |
Per i messaggi diretti, l'ID dell'altro utente nella conversazione. |
|
Conteggio membri
|
num_members | integer |
Numero di membri in questa conversazione. |
ListChannels_Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
channels
|
channels | array of Channel | |
|
Cursore successivo
|
response_metadata.next_cursor | string |
Cursore da passare alla richiesta successiva. Vuoto quando non sono presenti altri risultati. |
ListChannels_ResponseV3
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
value
|
value | array of Channel |
SlackMessage
Messaggio pubblicato in una conversazione slack.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID messaggio
|
ts | string |
Identificatore timestamp univoco del messaggio. |
|
ID autore
|
user | string |
ID dell'utente che ha pubblicato il messaggio. Usare Get user profile (Ottieni profilo utente) per risolvere questo problema in un utente. |
|
Testo del messaggio
|
text | string |
Corpo del messaggio. |
|
Tipo di messaggio
|
type | string |
Tipo del messaggio. |
|
Thread Id
|
thread_ts | string |
Timestamp del messaggio padre, se questo messaggio fa parte di un thread. |
|
Conteggio risposte
|
reply_count | integer |
Numero di risposte a questo messaggio, se avvia un thread. |
ListMessages_Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
value
|
value | array of SlackMessage |
SlackUserProfile
Dettagli aggiuntivi del profilo per un utente slack.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Nome visualizzato
|
display_name | string |
Nome visualizzato scelto dall'utente per il profilo. |
|
Nome reale
|
real_name | string |
Nome e cognome dell'utente. |
|
Posta elettronica
|
string |
Indirizzo di posta elettronica dell'utente. |
|
|
Avatar Url
|
image_72 | string |
URL di una versione in pixel 72x72 dell'avatar dell'utente. |
SlackUser
Un utente slack.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | string |
ID dell'utente. |
|
Nome utente
|
name | string |
Nome utente Slack dell'utente. |
|
Nome reale
|
real_name | string |
Nome e cognome dell'utente. |
|
Is Bot
|
is_bot | boolean |
Indica se l'utente è un bot. |
|
Disattivato
|
deleted | boolean |
Indica se l'account dell'utente è stato disattivato. |
|
Fuso orario
|
tz | string |
Fuso orario leggibile dell'utente. |
|
Profile
|
profile | SlackUserProfile |
Dettagli aggiuntivi del profilo per un utente slack. |
GetUserProfile_Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Risultato esito positivo
|
ok | boolean |
Indica se l'operazione ha avuto esito positivo. |
|
User
|
user | SlackUser |
Un utente slack. |
|
Messaggi di errore
|
error | string |
Dettagli dei messaggi di errore, se presenti. |
CreateChannel_Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Channel
|
channel | Channel |
Canale |
JoinChannel_Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Già nel canale
|
already_in_channel | boolean |
Indica se l'utente è già nel canale o meno. |
|
Channel
|
channel | Channel |
Canale |
JoinChannel_ResponseV2
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Channel
|
channel | Channel |
Canale |
|
Avvertimento
|
warning | string |
Indica se l'utente è già nel canale o meno. |
PostMessageResponse
Dettagli del messaggio inviato a un canale Slack.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Risultato esito positivo
|
ok | boolean |
Indica se l'operazione ha avuto esito positivo. |
|
Channel
|
channel | string |
Canale a cui è stato inviato il messaggio. |
|
Ora di creazione
|
ts | string |
Timestamp Unix per il momento in cui è stato creato il messaggio. |
|
Tipo di messaggio
|
message.type | string |
Tipo del messaggio. |
|
Testo del messaggio
|
message.text | string |
Corpo del messaggio. |
|
Ora di creazione
|
message.ts | string |
Timestamp Unix per il momento in cui è stato creato il messaggio. |
|
Messaggi di errore
|
error | string |
Dettagli dei messaggi di errore, se presenti. |