Etapa 3: Criar novo chat

Este método permite criar um chat antes de enviar a primeira mensagem.

Descrição

🚧

Esteja ciente de que você não poderá executar este passo diretamente na seção de Referência da API devido a limitações da ferramenta: não é possível calcular os cabeçalhos necessários e enviar uma solicitação simultaneamente.

Este método permite criar um chat antes de enviar a mensagem inicial. Pode ser benéfico quando existe um lead com contato e não há necessidade de criar um lead de entrada. Chats sem mensagens não serão visíveis na conta.

Você também pode especificar a fonte do chat, e quando a primeira mensagem de chat for recebida, um lead de entrada será criado no pipeline apropriado com base na fonte especificada.

Este método cria um chat para o ID passado. Se o chat para o conversation_id passado já existir, seu ID será retornado.

Cabeçalhos e Tipo de Autorização

Os cabeçalhos da solicitação são os mesmos para todas as solicitações da API de Chat.
Você pode aprender como obter os cabeçalhos Content-MD5 e X-Signature com a ajuda da receita.


❗️

  1. O user[id] deve ser único. Se você inserir um user[id] existente, receberá as informações existentes relacionadas a esse usuário.
  2. O corpo da solicitação deve ser exatamente o mesmo ao calcular o Content-MD5 e o X-Signature.

Parâmetros de resposta

ParâmetroDescrição
idID do chat na API de Chat da Kommo.
user[id]ID do participante do chat na API de Chat da Kommo.
user[client_id]ID do participante do chat no lado da integração (o campo está ausente para usuários do Kommo; é passado na solicitação com a chave user[id]).
user[name]Nome do participante do chat.
user[avatar]Link do avatar, se enviado, ou campo vazio.
user[phone]Número de telefone do participante do chat, se enviado.
user[email]Endereço de e-mail do participante do chat, se enviado.
Language