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

# Navegar o buscar en el directorio de canales públicos

> Monra la pantalla de "Encontrar canales" de los clientes oficiales. Sin
`search_text` navega por una `view` y requiere al menos un código
; con `search_text` busca canales por nombre (los códigos de país
no son compatibles con la búsqueda). Pagina con `cursor` mientras que
`has_more` es verdadero. Utiliza consultas indocumentadas de WhatsApp capturadas desde
WhatsApp Web, que pueden cambiar sin previo aviso.




## OpenAPI

````yaml /es/openapi.yml get /newsletter/directory
openapi: 3.0.0
info:
  title: Multidispositivo API de WhatsApp
  version: 9.7.0
  description: >
    Esta API se utiliza para enviar whatsapp a través de API.


    El panel web es un proyecto separado (gowa-ui); el servidor descarga su
    último recurso de versión

    y lo sirve en `/` (o devuelve un banner JSON cuando

    APP_UI_ENABLED=false).


    Ámbito del dispositivo:

    - Envía `X-Device-Id` en todas las llamadas REST con ámbito dispositivo.

    - WebSocket: conectar a `/ws?device_id=<id>`.

    - WebSocket auth (cuando la autenticación básica está habilitada): los
    navegadores no pueden establecer un encabezado
      de autorización en conexiones WebSocket, así que también pase
      `&authorization=<base64(user:pass)>` en la cadena de consulta. Usa TLS en producciónformat@@0
      ya que la credencial es visible en la URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Conexión inicial al servidor de Whatsapp
  - name: device
    description: Gestión de dispositivos para soporte multidispositivo
  - name: user
    description: Obteniendo información
  - name: send
    description: Enviar mensaje (Texto/Imágen/Archivo/Video).
  - name: message
    description: Manipulación de mensajes (revocar/react/actualizar).
  - name: call
    description: Gestión de llamadas (rechazar llamadas entrantes)
  - name: chat
    description: Chats de chat y mensajería
  - name: group
    description: Ajuste de grupo
  - name: newsletter
    description: configuración del boletín de noticias
  - name: chatwoot
    description: Integración de Chatwoot para soporte al cliente
paths:
  /newsletter/directory:
    get:
      tags:
        - newsletter
      summary: Navegar o buscar en el directorio de canales públicos
      description: >
        Monra la pantalla de "Encontrar canales" de los clientes oficiales. Sin

        `search_text` navega por una `view` y requiere al menos un código

        ; con `search_text` busca canales por nombre (los códigos de país

        no son compatibles con la búsqueda). Pagina con `cursor` mientras que

        `has_more` es verdadero. Utiliza consultas indocumentadas de WhatsApp
        capturadas desde

        WhatsApp Web, que pueden cambiar sin previo aviso.
      operationId: searchNewsletterDirectory
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - name: view
          in: query
          required: false
          schema:
            type: string
            enum:
              - RECOMMENDED
              - TRENDING
              - POPULAR
              - NEW
              - FEATURED
            default: RECOMMENDED
        - name: search_text
          in: query
          required: false
          schema:
            type: string
          example: news
        - name: country_codes
          in: query
          required: false
          description: >-
            ISO 3166-1 códigos alpha-2, repetidos o separados por comas.
            Necesario al navegar por una vista.
          schema:
            type: array
            items:
              type: string
          example:
            - ID
        - name: categories
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - BUSINESS
                - ENTERTAINMENT
                - LIFESTYLE
                - NEWS
                - ORGANIZATIONS
                - PEOPLE
                - SPORTS
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 50
        - name: cursor
          in: query
          required: false
          description: next_cursor de la página anterior
          schema:
            type: string
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsletterDirectoryResponse'
        '400':
          description: Solicitud incorrecta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Identificador de dispositivo para soporte multidispositivo. Requerido
        cuando se registran múltiples dispositivos.

        Si sólo se registra un dispositivo, se utilizará como el valor
        predeterminado.

        También se puede proporcionar como parámetro de consulta `device_id`.
      schema:
        type: string
        example: my-device-id
  schemas:
    NewsletterDirectoryResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success search newsletter directory
        results:
          type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/Newsletter'
            next_cursor:
              type: string
              example: GTby6Oiy0/jOqwPYxYXQtvjOqwPC0uaVue3OqwMZ
            has_more:
              type: boolean
              example: true
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: Código de estado HTTP
        message:
          type: string
          example: field cannot be blank
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: Error
        message:
          type: string
          example: you are not loggin
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    Newsletter:
      type: object
      properties:
        id:
          type: string
          example: 120363144038483540@newsletter
        state:
          type: object
          properties:
            type:
              type: string
              example: active
        thread_metadata:
          type: object
          properties:
            creation_time:
              type: string
              example: '1688746895'
            invite:
              type: string
              example: 0029Va4K0PZ5a245NkngBA2M
            name:
              type: object
              properties:
                text:
                  type: string
                  example: WhatsApp
                id:
                  type: string
                  example: '1688746895480511'
                update_time:
                  type: string
                  example: '1688746895480511'
            description:
              type: object
              properties:
                text:
                  type: string
                  example: >-
                    WhatsApp's official channel. Follow for our latest feature
                    launches, updates, exclusive drops and more.
                id:
                  type: string
                  example: '1689653839450668'
                update_time:
                  type: string
                  example: '1689653839450668'
            subscribers_count:
              type: string
              example: '0'
            verification:
              type: string
              example: verified
            picture:
              type: object
              properties:
                url:
                  type: string
                  example: ''
                id:
                  type: string
                  example: '1707950960975554'
                type:
                  type: string
                  example: IMAGE
                direct_path:
                  type: string
                  example: >-
                    /v/t61.24694-24/416962407_970228831134395_8869146381947923973_n.jpg?ccb=11-4&oh=01_Q5AaIIvOIeu3l0HCZWILrmr-dGR_vXFqnhUeytw0-ojPc4hL&oe=670D95B1&_nc_sid=5e03e0&_nc_cat=110
            preview:
              type: object
              properties:
                url:
                  type: string
                  example: ''
                id:
                  type: string
                  example: '1707950960975554'
                type:
                  type: string
                  example: PREVIEW
                direct_path:
                  type: string
                  example: >-
                    /v/t61.24694-24/416962407_970228831134395_8869146381947923973_n.jpg?stp=dst-jpg_s192x192&ccb=11-4&oh=01_Q5AaIHO-DQklqm3q3awF7xwji_WAn9DkgZASQA0B2Ct0qbSa&oe=670D95B1&_nc_sid=5e03e0&_nc_cat=110
            settings:
              type: object
              properties:
                reaction_codes:
                  type: object
                  properties:
                    value:
                      type: string
                      example: ALL
        viewer_metadata:
          type: object
          nullable: true
          description: >-
            Nulo cuando los metadatos específicos del visor no están
            disponibles.
          properties:
            mute:
              type: string
              example: 'off'
            role:
              type: string
              example: subscriber
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Canales de WhatsApp](https://gowa-docs.mintlify.site/es/examples/newsletters.md)
- [Sesiones y ciclo de vida de la conexión](https://gowa-docs.mintlify.site/es/concepts/sessions.md)
- [Manejo de medios](https://gowa-docs.mintlify.site/es/examples/media-handling.md)
- [Integración de Chatwoot](https://gowa-docs.mintlify.site/es/integrations/chatwoot.md)
- [Referencia de configuración](https://gowa-docs.mintlify.site/es/configuration.md)


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