> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jurichat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar contatos em lote

> Importa contatos para uma ou mais inboxes. Campos obrigatórios: name e phoneNumber. Com createConversation=true, também cria conversa na integração informada (integrationId). Retorna o que foi criado e o que falhou.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json post /people/import
openapi: 3.1.0
info:
  title: JuriChat API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.jurichat.com
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /people/import:
    post:
      tags:
        - Contacts
      summary: Importar contatos em lote
      description: >-
        Importa contatos para uma ou mais inboxes. Campos obrigatórios: name e
        phoneNumber. Com createConversation=true, também cria conversa na
        integração informada (integrationId). Retorna o que foi criado e o que
        falhou.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                inboxIds:
                  type: array
                  items:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                  minItems: 1
                  description: Inboxes de destino do importe.
                contacts:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                        minLength: 1
                        description: Nome do contato.
                      phoneNumber:
                        type: string
                        minLength: 1
                        description: Telefone do contato.
                      email:
                        type: string
                        format: email
                        description: E-mail do contato.
                      document:
                        type: string
                        description: CPF ou CNPJ do contato.
                      description:
                        type: string
                        description: Anotações sobre o contato.
                      country:
                        type: string
                        description: País do contato.
                      city:
                        type: string
                        description: Cidade do contato.
                      isBlocked:
                        type: boolean
                        description: 'Define se o contato começa bloqueado. Padrão: false.'
                      tags:
                        type: array
                        items:
                          type: string
                          pattern: ^[cC][^\s-]{8,}$
                        description: IDs de tags existentes na inbox de destino.
                    required:
                      - name
                      - phoneNumber
                    additionalProperties: false
                  minItems: 1
                  maxItems: 5000
                  description: Lista de contatos a importar.
                createConversation:
                  type: boolean
                  default: false
                  description: >-
                    Quando true, cria uma conversa para cada contato novo na
                    integração informada.
                integrationId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: >-
                    Canal de integração (WhatsApp, web chat etc.) onde a
                    conversa será criada. Obrigatório quando createConversation
                    é true.
              required:
                - inboxIds
                - contacts
              additionalProperties: false
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  created:
                    type: array
                    items:
                      type: object
                      properties:
                        index:
                          type: integer
                          description: Índice do contato na lista enviada.
                        id:
                          type: string
                          pattern: ^[cC][^\s-]{8,}$
                          description: ID do contato criado.
                        name:
                          type: string
                          description: Nome do contato criado.
                        phoneNumber:
                          type: string
                          nullable: true
                          description: Telefone normalizado do contato.
                        email:
                          type: string
                        document:
                          type: string
                        description:
                          type: string
                        country:
                          type: string
                        city:
                          type: string
                        isBlocked:
                          type: boolean
                        inboxId:
                          type: string
                          description: Inbox onde o contato foi criado.
                        conversationId:
                          type: string
                          pattern: ^[cC][^\s-]{8,}$
                          description: >-
                            ID da conversa criada ou reutilizada quando
                            createConversation é true.
                      required:
                        - index
                        - id
                        - name
                        - phoneNumber
                        - isBlocked
                        - inboxId
                      additionalProperties: false
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        index:
                          type: integer
                          description: Índice do contato na lista enviada.
                        inboxId:
                          type: string
                          description: Inbox alvo quando aplicável.
                        name:
                          type: string
                        phoneNumber:
                          type: string
                        reason:
                          type: string
                          description: Motivo da falha ou duplicata.
                      required:
                        - index
                        - reason
                      additionalProperties: false
                required:
                  - created
                  - errors
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  code:
                    type: string
                  details:
                    anyOf:
                      - type: string
                      - type: number
                      - type: boolean
                      - type: object
                        properties: {}
                        additionalProperties: true
                    description: Detalhes adicionais do erro.
                required:
                  - message
                  - statusCode
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-jurichat-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-jurichat-api-key.

````