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

# Listar modelos da Meta

> Lista os modelos de mensagem (templates) cadastrados na Meta para uma integração do WhatsApp Oficial. A lista é paginada por cursor: enquanto `paging.hasNext` for verdadeiro, repita a chamada enviando `paging.after` no parâmetro `after`.



## OpenAPI

````yaml GET /meta-template/list
openapi: 3.1.0
info:
  title: OpenAPI Multchats
  description: Multchats API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.multchats.com/v2
security:
  - bearerAuth: []
paths:
  /meta-template/list:
    get:
      tags:
        - Meta Template
      summary: Listar modelos da Meta
      description: >-
        Lista os modelos de mensagem (templates) cadastrados na Meta para uma
        integração do WhatsApp Oficial. A lista é paginada por cursor: enquanto
        `paging.hasNext` for verdadeiro, repita a chamada enviando
        `paging.after` no parâmetro `after`.
      parameters:
        - name: integrationId
          description: ID da integração do WhatsApp Oficial
          in: query
          required: true
          schema:
            type: string
            pattern: ^c[a-z0-9]{24}$
        - name: limit
          description: >-
            Quantidade de modelos por página (1 a 250). Sem este parâmetro, a
            Meta retorna 25
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 250
        - name: after
          description: Cursor da página anterior, devolvido em `paging.after`
          in: query
          required: false
          schema:
            type: string
        - name: status
          description: Retorna apenas os modelos neste status
          in: query
          required: false
          schema:
            type: string
            enum:
              - APPROVED
              - PENDING
              - REJECTED
              - DISABLED
              - PAUSED
              - IN_APPEAL
              - PENDING_DELETION
        - name: search
          description: Busca pelo nome ou pelo conteúdo do modelo
          in: query
          required: false
          schema:
            type: string
            maxLength: 255
      responses:
        '200':
          description: Modelos listados com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListMetaTemplatesResponse'
        '400':
          description: Erro na requisição
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ListMetaTemplatesResponse:
      type: object
      properties:
        success:
          description: Indica se a operação foi bem-sucedida
          type: boolean
          default: true
        response:
          description: Modelos da página e a posição na lista
          type: object
          properties:
            templates:
              type: array
              items:
                $ref: '#/components/schemas/MetaTemplate'
            paging:
              $ref: '#/components/schemas/MetaTemplatePaging'
    Error:
      required:
        - success
        - message
      type: object
      properties:
        success:
          description: Indica se a operação foi bem-sucedida
          type: boolean
          default: false
        message:
          description: Mensagem de erro (quando success é false)
          type: string
          default: Erro ao enviar mensagem
    MetaTemplate:
      type: object
      description: Modelo de mensagem exatamente como a Meta o retorna
      properties:
        id:
          description: ID do modelo na Meta, usado para enviá-lo
          type: string
        name:
          description: Nome do modelo
          type: string
        language:
          description: 'Idioma do modelo. Ex: pt_BR'
          type: string
        status:
          description: >-
            Situação do modelo na Meta. Apenas modelos APPROVED podem ser
            enviados
          type: string
          enum:
            - APPROVED
            - PENDING
            - REJECTED
            - DISABLED
            - PAUSED
            - IN_APPEAL
            - PENDING_DELETION
        category:
          description: Categoria do modelo
          type: string
          enum:
            - AUTHENTICATION
            - MARKETING
            - UTILITY
        sub_category:
          description: Subcategoria do modelo, quando a Meta a informa
          type: string
          nullable: true
        parameter_format:
          description: >-
            Formato das variáveis do modelo: nomeadas ({{nome}}) ou posicionais
            ({{1}})
          type: string
          enum:
            - NAMED
            - POSITIONAL
        components:
          description: Partes que formam o modelo
          type: array
          items:
            $ref: '#/components/schemas/MetaTemplateComponent'
        quality_score:
          description: Qualidade do modelo medida pela Meta
          type: object
          nullable: true
          properties:
            score:
              description: 'Nota atribuída pela Meta. Ex: GREEN, YELLOW, RED, UNKNOWN'
              type: string
    MetaTemplatePaging:
      type: object
      description: Onde a lista continua
      properties:
        after:
          description: Cursor a enviar em `after` para ler a próxima página
          type: string
          nullable: true
        hasNext:
          description: >-
            Indica se existe uma próxima página. A Meta devolve cursor também na
            última página, então este é o campo a consultar
          type: boolean
    MetaTemplateComponent:
      type: object
      description: >-
        Parte do modelo (cabeçalho, corpo, rodapé ou botões), como a Meta a
        retorna
      properties:
        type:
          description: Tipo da parte
          type: string
          enum:
            - HEADER
            - BODY
            - FOOTER
            - BUTTONS
        format:
          description: Formato do cabeçalho, presente apenas em HEADER
          type: string
          enum:
            - TEXT
            - IMAGE
            - VIDEO
            - DOCUMENT
            - LOCATION
        text:
          description: Texto da parte, com as variáveis do modelo
          type: string
        example:
          description: >-
            Exemplos de preenchimento das variáveis, enviados na criação do
            modelo
          type: object
        buttons:
          description: Botões do modelo, presentes apenas em BUTTONS
          type: array
          items:
            type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````