O que são APIs de várias partes e como usar APIs de várias partes para enviar anexos do seu bot?

Você pode usar APIs Multipart para combinar e enviar vários conjuntos de dados, como anexos, de suas conversas de bot para seus sistemas de terceiros preferidos.

O formato de dados de formulário multiparte em APIs REST combina um ou mais conjuntos de dados em um único corpo, separados por limites. Normalmente, você usa essas solicitações para uploads de arquivos e para transferir dados de vários tipos em uma única solicitação (por exemplo, um arquivo junto com um objeto JSON). 

Com o suporte a dados de formulário Multipart em nossa biblioteca de API, você pode passar anexos de arquivo e outras informações coletadas durante a conversa do bot para aplicativos de terceiros que oferecem suporte a APIs REST. 

• Por exemplo, quando seus clientes interagem com seu bot, você pode usar o formato de dados de formulário Multipart em APIs REST para coletar contexto adicional com anexos de arquivo e passá-lo para o Freshdesk para criar um ticket.  

Configurando a API multipartes

• Navegue até Bots e crie um novo bot ou selecione um bot existente

• Navegue até Flows > Configure > API library .

• O botão Nova API permitirá que você configure uma nova chamada de API.

• Ao escolher um método como POST ou PUT, você terá a opção de selecionar entre os tipos de carga útil de dados de formulário JSON ou Multipart.

• Escolha Dados de formulário de várias partes no menu suspenso Tipo de carga útil. Agora você pode ver que um conjunto de campos de conteúdo de carga estruturada estará disponível para configuração.

• Você pode inserir o nome da chave e seu tipo de conteúdo nesta carga útil. O tipo de conteúdo associado à chave pode ser texto ou tipo de arquivo.

Tipo de conteúdo: Texto	Tipo de conteúdo: anexos
Para a chave com tipo de conteúdo como texto, o valor pode ser codificado ou pode ser configurado usando um seletor de conteúdo de um diálogo que coleta a entrada do campo de texto .  Neste exemplo, o Dialog 1.2 coletará a entrada de texto do cliente.	Para a chave com tipo de conteúdo como Arquivo, configure o valor usando um seletor de conteúdo de um Diálogo que coleta entrada de Arquivo e Imagem .  Neste exemplo, o Dialog 3.1 coletará um arquivo ou imagem do cliente.
A API de dados de formulário Multipart pode ser configurada para obter o valor do Dialog 1.2, que pode então ser transmitido por meio da API. Os valores de texto também podem ser codificados a partir da biblioteca API.	A API de dados de formulário Multipart pode ser configurada para obter o valor do Dialog 3.1, que pode ser transmitido por meio da API.

Acionando a API Multipart no fluxo do bot

• Depois de configurar a API de dados de formulário em várias partes, você pode acionar a API no fluxo do bot.

• Se a chamada da API for bem-sucedida , o texto ou anexo relevante será transmitido ao seu aplicativo de terceiros.

• Se a chamada de API falhar , o status e os logs relevantes da API estarão disponíveis em Conversas > Chamadas de API  para depurar e corrigir a configuração.