> ## Documentation Index > Fetch the complete documentation index at: https://docs.airys.chat/llms.txt > Use this file to discover all available pages before exploring further. # Criar novo conversa > Criar uma conversa no chatwoot requer um source id. Saiba mais sobre source_id: https://www.chatwoot.com/hc/user-guide/articles/1677839703-how-to-create-an-api-channel-inbox#send-messages-to-the-api-channel ## OpenAPI ````yaml /pt-br/swagger/tag_groups/application_swagger.json post /api/v1/accounts/{account_id}/conversations openapi: 3.1.0 info: title: Chatwoot description: Esta é a documentação da API para o servidor Chatwoot. version: 1.1.0 termsOfService: https://www.chatwoot.com/terms-of-service/ contact: email: hello@chatwoot.com license: name: MIT License url: https://opensource.org/licenses/MIT servers: - url: https://airys.chat/ security: [] tags: - name: AgentBots de Conta description: Agent Bots específicos da conta - name: Agentes description: APIs de gerenciamento de agentes - name: Respostas Prontas description: Respostas predefinidas para consultas comuns - name: Contatos description: APIs de gerenciamento de contatos - name: Rótulos de Contato description: Gerenciar rótulos de contato - name: Atribuições de Conversa description: Gerenciar atribuições de conversas - name: Rótulos de Conversa description: Gerenciar rótulos de conversas - name: Conversas description: APIs de gerenciamento de conversas - name: Atributos Personalizados description: Campos personalizados para contatos e conversas - name: Filtros Personalizados description: Filtros salvos para conversas - name: Caixas de Entrada description: Configuração de canais de comunicação - name: Integrações description: Integrações de terceiros - name: Rótulos description: APIs de gerenciamento de rótulos da conta - name: Mensagens description: APIs de gerenciamento de mensagens - name: Perfil description: APIs de perfil de usuário - name: Relatórios description: APIs de análise e relatórios - name: Equipes description: APIs de gerenciamento de equipe - name: Webhooks description: Webhooks de notificação de eventos - name: Regra de Automação description: Regras de automação de fluxo de trabalho - name: Central de Ajuda description: Gerenciamento da base de conhecimento paths: /api/v1/accounts/{account_id}/conversations: parameters: - $ref: '#/components/parameters/account_id' post: tags: - Conversas summary: Criar novo conversa description: |- Criar uma conversa no chatwoot requer um source id. Saiba mais sobre source_id: https://www.chatwoot.com/hc/user-guide/articles/1677839703-how-to-create-an-api-channel-inbox#send-messages-to-the-api-channel operationId: newConversation requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/conversation_create_payload' responses: '200': description: Sucesso content: application/json: schema: type: object properties: id: type: number description: ID da conversa account_id: type: number description: ID da conta inbox_id: type: number description: ID da caixa de entrada '403': description: Acesso negado content: application/json: schema: $ref: '#/components/schemas/bad_request_error' security: - userApiKey: [] - agentBotApiKey: [] components: parameters: account_id: in: path name: account_id schema: type: integer required: true description: O ID numérico da conta schemas: conversation_create_payload: type: object required: - source_id properties: source_id: type: string description: Id de origem da conversa (source id) example: '1234567890' inbox_id: type: integer description: >- Id da caixa de entrada na qual a conversa é criada
Tipos de caixa de entrada permitidos: Website, Phone, Api, Email example: 1 contact_id: type: integer description: Id do contato para o qual a conversa é criada example: 1 additional_attributes: type: object description: Permite especificar atributos como informações do navegador example: browser: Chrome browser_version: 89.0.4389.82 os: Windows os_version: '10' custom_attributes: type: object description: >- O objeto para salvar atributos personalizados para a conversa, aceita chave e valor de atributos personalizados example: attribute_key: attribute_value priority_conversation_number: 3 status: type: string enum: - open - resolved - pending description: Especifique a conversa se estiver pendente, aberta, fechada example: open assignee_id: type: integer description: Id do agente para atribuir uma conversa a um agente example: 1 team_id: type: integer description: Id da equipe para atribuir uma conversa a uma equipe\ example: 1 snoozed_until: type: string format: date-time description: Adiada até a data e hora example: '2030-07-21T17:32:28Z' message: type: object description: A mensagem inicial a ser enviada para a conversa required: - content properties: content: type: string description: O conteúdo da mensagem example: Hello, how can I help you? template_params: type: object description: >- Os parâmetros do modelo para a mensagem no caso do Canal WhatsApp properties: name: type: string description: Nome do modelo example: sample_issue_resolution category: type: string description: Categoria do modelo example: UTILITY language: type: string description: Idioma do modelo example: en_US processed_params: type: object description: >- Os valores de parâmetro processados ​​para variáveis ​​de modelo no modelo example: '1': Chatwoot bad_request_error: title: data type: object properties: description: type: string errors: type: array items: $ref: '#/components/schemas/request_error' request_error: type: object properties: field: type: string message: type: string code: type: string securitySchemes: userApiKey: type: apiKey in: header name: api_access_token description: >- Este token pode ser obtido visitando a página de perfil ou por meio do console rails. Fornece acesso a endpoints com base nos níveis de permissões do usuário. Este token pode ser salvo por um sistema externo quando o usuário é criado via API, para realizar atividades em nome do usuário. agentBotApiKey: type: apiKey in: header name: api_access_token description: >- Este token deve ser fornecido pelo administrador do sistema ou obtido pelo console rails. Este token pode ser usado para construir integrações de bots e só pode acessar apis limitadas. ````