---
title: "Etapa 3: Criar novo chat"
method: POST
path: "/{scope_id}/chats"
---

# Etapa 3: Criar novo chat

`POST /{scope_id}/chats`

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

## Path parameters

- `scope_id` string, required

## Headers

- `Date` string, required
- `Content-type` 'application/json'
- `Content-MD5` string
- `X-Signature` string

## Request body

- object
  - `conversation_id` string, required — ID do chat no lado da integração (sua integração deve gerá-lo, pode ser um número de telefone ou um nome de usuário).
  - `source` object
    - `external_id` string — Identificador da fonte do chat no lado da integração. Se você não precisar especificar a fonte, o campo de origem não precisa ser passado.
  - `user` object
    - `id` string, required — ID do participante do chat no lado da integração (você gera o ID).
    - `name` string — Nome do participante do chat.
    - `avatar` string — URL do avatar do participante do chat. O link deve estar disponível para download.
    - `profile` object
      - `phone` string — Número de telefone. Ao criar um lead de entrada, o número de telefone será adicionado aos dados de contato
      - `email` string — Endereço de e-mail. Ao criar um lead de entrada, o endereço de e-mail será adicionado aos dados de contato
  - `profile_link` string — URL para o perfil do participante do chat.

## Response `200`

200

- object
  - `id` string
  - `user` object
    - `id` string
    - `client_id` string
    - `name` string
    - `avatar` string
    - `phone` string
    - `email` string

## Other responses

- `400` — 400
- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo.md) · [All operations](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/referencias-de-api-da-kommo/revisions/98fdf05c2f5b/schema)