Condividi tramite

Creare messaggi con l'API Bot Connector

Il bot invierà attività oggetti di tipo messaggio per comunicare informazioni agli utenti e, analogamente, riceverà anche attività messaggio dagli utenti. Alcuni messaggi possono essere semplicemente costituiti da testo normale, mentre altri possono contenere contenuti più avanzati, ad esempio azioni suggerite, allegati multimediali, schede avanzatee dati specifici del canale. Questo articolo descrive alcune delle proprietà dei messaggi di uso comune.

Testo e formattazione del messaggio

Il testo del messaggio può essere formattato usando normale, markdowno xml. Il formato predefinito per la proprietà textFormat è markdown e interpreta il testo usando gli standard di formattazione Markdown. Il livello di supporto del formato di testo varia a seconda dei canali.

Suggerimento

Per informazioni su quali funzionalità sono supportate in ciascun canale, consultare l'articolo di riferimento dei canali .

La proprietà textFormat dell'oggetto activity può essere utilizzata per specificare il formato del testo. Ad esempio, per creare un messaggio di base contenente solo testo normale, impostare la proprietà textFormat dell'oggetto Activity su normale, impostare la proprietà text sul contenuto del messaggio e impostare la proprietà locale sulle impostazioni locali del mittente.

Allegati

La proprietà attachments dell'oggetto Activity può essere usata per inviare semplici allegati multimediali (immagine, audio, video, file) e schede avanzate. Per informazioni dettagliate, vedere Aggiungere allegati multimediali ai messaggi e Aggiungere schede avanzate ai messaggi.

Entità

La proprietà entities dell'oggetto Activity è una matrice di oggetti schema.org aperti che consente lo scambio di metadati contestuali comuni tra il canale e il bot.

Menzionare le entità

Molti canali supportano la possibilità per un bot o un utente di "menzionare" qualcuno all'interno del 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à entities del messaggio con oggetti Place.

Dati del canale

La proprietà channelData dell'oggetto attività può essere utilizzata per implementare funzionalità specifiche del canale. Per informazioni dettagliate, vedere Implementare funzionalità specifiche del canale.

Azioni suggerite

La proprietà suggestedActions dell'oggetto attività può essere utilizzata per presentare pulsanti che l'utente può toccare per fornire l'input. A differenza dei pulsanti visualizzati all'interno di schede avanzate (che rimangono visibili e accessibili all'utente anche dopo essere stati toccati), i pulsanti visualizzati all'interno del riquadro azioni suggeriti scompariranno dopo che l'utente effettua una selezione. Per informazioni dettagliate, vedere Aggiungere azioni suggerite ai messaggi.

Risorse aggiuntive