Creare messaggi con l'API Bot Connector
Il bot invierà gli oggetti Attività di tipo message per comunicare informazioni e ricevere attività message dagli utenti. Alcuni messaggi possono contenere semplicemente testo normale, mentre altri possono avere contenuti avanzati, come testo da pronunciare, azioni consigliate, allegati multimediali, schede avanzate e dati specifici del canale. Questo articolo descrive alcune delle proprietà del messaggio di uso comune.
Testo del messaggio e formattazione
Il testo del messaggio può essere formattato usando plain, markdown, o xml. Il formato predefinito per la proprietà textFormat è markdown e interpreta il testo con standard di formattazione markdown. Il livello di supporto del formato di testo varia tra i canali.
Suggerimento
Per informazioni sulle funzionalità supportate in ogni canale, vedere l'articolo di riferimento sui canali .
La proprietà textFormat di un oggetto Attività può essere usata per specificare il formato del testo. Ad esempio, per creare un messaggio di base che contiene solo testo normale, impostare la proprietà textFormat dell'oggetto Activity su plain, impostare la proprietà text nel contenuto del messaggio e impostare la proprietà locale nelle impostazioni locali del mittente.
Allegati
La proprietà attachments dell'oggetto Attività può essere usata per inviare schede avanzate e allegati multimediali semplici (immagine, audio, video, file). Per informazioni dettagliate, vedere Aggiungere allegati multimediali ai messaggi e Aggiungere schede avanzate ai messaggi.
Entità
La proprietà entities dell'oggetto Attività è una matrice di oggetti schema.org aperti che consente lo scambio di metadati contestuali comuni tra il canale e il bot.
Entità mention
Molti canali supportano la possibilità per un bot o un utente di "menzionare" qualcuno nel contesto di una conversazione. Per menzionare un utente in un messaggio, popolare la proprietà entities del messaggio con un oggetto Mention.
Posizionare le entità
Per trasmettere informazioni relative alla posizione all'interno di un messaggio, popolare la proprietà del entities messaggio con oggetti Place .
Dati del canale
La proprietà channelData dell'oggetto Attività può essere usata per implementare funzionalità specifiche del canale. Per informazioni dettagliate, vedere Implementare funzionalità specifiche del canale.
Testo di cui eseguire il riconoscimento vocale
La proprietà speak dell'oggetto Attività può essere usata per specificare il testo che deve pronunciare il bot in un canale abilitato al riconoscimento vocale e la proprietà inputHint dell'oggetto Activity può essere usata per influenzare lo stato del microfono del client. Per informazioni dettagliate, vedere Aggiungere il riconoscimento vocale i messaggi e Aggiungere suggerimenti per l'input ai messaggi.
Azioni suggerite
La proprietà suggestedActions dell'oggetto Attività può essere usata per presentare i pulsanti che l'utente può toccare per fornire input. A differenza dei pulsanti presenti all'interno di schede avanzate (che restano visibili e accessibili all'utente anche dopo averli toccati), i pulsanti visualizzati all'interno del riquadro azioni consigliate non verranno più visualizzati dopo che l'utente effettua una selezione. Per informazioni dettagliate, vedere Aggiungere azioni suggerite ai messaggi.
Risorse aggiuntive
- Informazioni di riferimento sui canali
- Panoramica delle attività
- Inviare e ricevere messaggi
- Aggiungere allegati multimediali ai messaggi
- Aggiungere schede avanzate ai messaggi
- Aggiungere il riconoscimento vocale ai messaggi
- Aggiungere suggerimenti di input ai messaggi
- Aggiungere azioni suggerite ai messaggi
- Implementare funzionalità specifiche del canale