[`mgt-new-chat`] Sending cards as part of the conversation creation

[sebastienlevert]

Developers should be able to send an adaptive card as the first message of a conversation.

Based on the following API call: https://learn.microsoft.com/en-us/graph/api/chatmessage-post?view=graph-rest-1.0&tabs=http#example-3-send-message-containing-cards

• Using a property on the createNewChat function, developers can pass in an already formatted adaptive card as the first message and an extra boolean to indicate this message is an adaptive card. The function will do the extra work to create the attachment and set the body with the correct format.

createNewChat(memberIds, true, adaptiveCardMessage, true, chatName);

• When using the NewChat component, a property on the component also prevents the component to render an initial message control, where the developer would own the entire initial message experience. 2 new properties allow developers to set the message that gets sent and if it's an adaptive card or not.

<NewChat
    hideInitialMessage={true}
    initialMessage={adaptiveCardMessage}
    initialMessageIsAdaptiveCard={true}
/>

• Initially, we would not support messages AND adaptive cards at the same time. Something to consider in the future.

[ghost]

Hello sebastienlevert, thank you for opening an issue with us!

I have automatically added a "needs triage" label to help get things started. Our team will analyze and investigate the issue, and escalate it to the relevant team if possible. Other community members may also look into the issue and provide feedback 🙌

[gavinbarron]

@sebastienlevert is this handled by the existing component/function or do we need to add an async call back to the component which can be called between the creation of the thread and the sending of the first message if supplied?

[sebastienlevert]

It should be handled by the native component and functions. No callbacks needed.

[gavinbarron]

Can you please write me a spec or a more detailed explanation of how that will work in practice, how will the developer using the component pass in the card? Do we have docs or example code of adding a card to a newly created conversation? If the user chooses to have a message as well as a card are they separate messages? If so which comes first?

[sebastienlevert]

@gavinbarron I updated the description, please le me know if it becomes clearer. Thanks!