Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Importante
Este artigo descreve como iniciar uma conversa usando a API de linha direta 1.1. Se você estiver criando uma nova conexão entre o aplicativo cliente e o bot, use Direct Line API 3.0.
As conversas de linha diretas explicitamente são abertas pelos clientes e podem ser executadas desde que o cliente e o bot participarem e tem credenciais válidas. Enquanto a conversa está aberta, o bot e o cliente podem enviar mensagens. Mais de um cliente pode se conectar a uma determinada conversa e cada cliente pode participar em nome de vários usuários.
Abra uma nova conversa
Para abrir uma nova conversa com um bot, execute esta solicitação:
POST https://directline.botframework.com/api/conversations
Authorization: Bearer SECRET_OR_TOKEN
Os snippets de código a seguir fornecem um exemplo de conversa Iniciar solicitação e resposta.
Solicitação
POST https://directline.botframework.com/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn
Resposta
Se a solicitação for bem-sucedida, a resposta conterá um ID para a conversa, um token e um valor que indica o número de segundos até que o token expire.
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800
}
Iniciar conversa em vez de gerar o Token
A operação Iniciar Conversa (POST /api/conversations
) é semelhante à operação Gerar Token (POST /api/tokens/conversation
) em que ambas as operações retornam um token
que pode ser usado para acessar uma única conversa. No entanto, a operação Iniciar Conversa também inicia a conversa e entra em contato com o bot, enquanto a operação Gerar Token não faz nada disso.
Se você pretende iniciar a conversa imediatamente, use a operação Iniciar Conversa. Se você planeja distribuir o token para clientes e deseja que eles iniciem a conversa, use a operação Gerar Token.