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

# Listar quién queda fuera de la campaña

> Personas de la audiencia que no reciben la campaña, con el motivo. No se crea ninguna inscripción. Recibe el mismo cuerpo de la vista previa de audiencia, más paginación, búsqueda por nombre y filtro por motivo.



## OpenAPI

````yaml /es/openapi.json post /v1/campaigns/audience-preview/excluded
openapi: 3.0.0
info:
  title: Nuvia API - Empresa
  description: Documentación de la API para empresas
  version: '1.0'
  contact: {}
servers:
  - url: https://api.nuvia.ai
security: []
tags:
  - name: messages
    x-group: Mensagens
  - name: contacts
    x-group: Contatos
  - name: campaigns
    x-group: Campanhas
  - name: tables
    x-group: Tabelas e Listas
  - name: agents
    x-group: Agentes
  - name: conversations
    x-group: Conversas
  - name: inboxes
    x-group: Caixas de Entrada
  - name: knowledge
    x-group: Base de Conhecimento
  - name: Webhooks
    x-group: Webhooks
  - name: campaign-enrollments
    x-group: Inscrições em Campanha
  - name: custom-fields
    x-group: Campos Customizados
  - name: resources
    x-group: Arquivos e Anexos
  - name: hubspot
    x-group: HubSpot
paths:
  /v1/campaigns/audience-preview/excluded:
    post:
      tags:
        - campaigns
      summary: Listar quién queda fuera de la campaña
      description: >-
        Personas de la audiencia que no reciben la campaña, con el motivo. No se
        crea ninguna inscripción. Recibe el mismo cuerpo de la vista previa de
        audiencia, más paginación, búsqueda por nombre y filtro por motivo.
      operationId: CampaignController_audiencePreviewExcluded
      parameters:
        - name: x-company-id
          in: header
          description: >-
            Identificador de la empresa objetivo. Obligatorio solo para API keys
            globales (type=global). Se ignora para API keys de empresa y
            usuarios humanos.
          required: false
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudiencePreviewExcludedBodyDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
      security:
        - JWT-auth: []
components:
  schemas:
    AudiencePreviewExcludedBodyDto:
      type: object
      properties:
        channel_type:
          type: string
          description: Canal de envío de la campaña. Define la validación por canal.
          enum:
            - WAP_AUTO_CLOSER
            - WEB_V2
            - EVOLUTION_API
            - LINKEDIN
            - MULTI_CHANNEL
        audience_config:
          type: object
          description: >-
            Audiencia simulada, en el mismo formato de la creación de la
            campaña.
          properties:
            type:
              description: Tipo de audiencia.
              type: string
              enum:
                - STATIC
                - DYNAMIC
                - EXTERNAL
                - LIST
                - FUNNEL
            contact_ids:
              description: IDs de los contactos, para audiencia `STATIC`.
              type: array
              items:
                type: string
            lists:
              description: Listas de contactos, para audiencia `LIST`.
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    description: ID de la lista.
                  views:
                    description: >-
                      IDs de las vistas de la lista. Hoy no restringen nada: se
                      considera la lista completa.
                    type: array
                    items:
                      type: string
                required:
                  - id
            funnel_config:
              description: >-
                Embudo (agente) y, opcionalmente, etapa, para audiencia
                `FUNNEL`.
              type: object
              properties:
                agent_id:
                  type: string
                  minLength: 1
                agent_step_id:
                  type: string
              required:
                - agent_id
            match_criteria:
              description: Filtros por campo aplicados a la audiencia.
              type: object
              properties:
                match_logic:
                  default: AND
                  description: Lógica de combinación entre grupos
                  type: string
                  enum:
                    - AND
                    - OR
                filter_groups:
                  minItems: 1
                  type: array
                  items:
                    type: object
                    properties:
                      logic:
                        type: string
                        enum:
                          - AND
                          - OR
                        description: Lógica de combinación de las condiciones
                      conditions:
                        minItems: 1
                        type: array
                        items:
                          anyOf:
                            - type: object
                              properties:
                                field_id:
                                  type: string
                                  minLength: 1
                                  description: >-
                                    ID del campo personalizado o path fijo (ej.:
                                    contact.name, contact.email)
                                operator:
                                  type: string
                                  enum:
                                    - eq
                                    - neq
                                    - gt
                                    - gte
                                    - lt
                                    - lte
                                    - contains
                                    - not_contains
                                    - starts_with
                                    - ends_with
                                    - is_empty
                                    - is_not_empty
                                    - in
                                    - not_in
                                  description: Operador de comparación
                                value:
                                  description: Valor para la comparación
                                  anyOf:
                                    - type: string
                                      nullable: true
                                    - type: number
                                      nullable: true
                                    - type: boolean
                                      nullable: true
                                    - type: array
                                      items:
                                        type: string
                                      nullable: true
                              required:
                                - field_id
                                - operator
                            - type: object
                    required:
                      - logic
                      - conditions
              required:
                - filter_groups
        behavior_config:
          type: object
          description: >-
            Regla de conversación abierta, tal como está configurada en la
            pantalla.
          properties:
            skip_if_active_conversation:
              description: >-
                Si es true, quien ya tiene una conversación abierta queda fuera
                (regla "Ya tiene conversación abierta").
              type: boolean
            active_conversation_window_minutes:
              description: Ventana, en minutos, que define una conversación abierta.
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
        exclusion_lists:
          type: array
          description: >-
            Listas de exclusión, en el orden en que se agregaron. Quien esté en
            ellas queda fuera.
          items:
            type: object
            properties:
              id:
                type: string
                description: ID de la lista de exclusión.
            required:
              - id
        page:
          type: integer
          description: Página. Valor predeterminado 1.
          minimum: -9007199254740991
          maximum: 9007199254740991
        limit:
          type: integer
          description: Elementos por página. Valor predeterminado 20, máximo 100.
          minimum: -9007199254740991
          maximum: 9007199254740991
        search:
          type: string
          description: Búsqueda por el nombre del contacto.
        reason:
          type: string
          description: Filtra por el motivo de quedar fuera. Valor predeterminado `all`.
          enum:
            - all
            - filtered_out
            - active_conversation
            - exclusion_list
            - no_active_channel
  securitySchemes:
    JWT-auth:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Token JWT de autenticación

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.