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

# Obter Foto do Grupo

> Obter a foto de perfil do grupo

## Descrição

Este endpoint retorna a URL da foto de perfil do grupo especificado.

## Parâmetros de URL

<ParamField path="session" type="string" required>
  ID único da sessão WhatsApp
</ParamField>

<ParamField path="id" type="string" required>
  ID do grupo no formato `120363XXXXX@g.us`
</ParamField>

## Resposta

<ResponseField name="url" type="string">
  URL da foto do grupo
</ResponseField>

<ResponseExample>
  ```json Resposta de Sucesso theme={null}
  {
    "url": "https://pps.whatsapp.net/v/t61.24694-24/..."
  }
  ```
</ResponseExample>

## Códigos de Status

* `200` - Foto retornada com sucesso
* `400` - Parâmetros inválidos
* `401` - Não autorizado
* `404` - Grupo ou foto não encontrado

## Exemplo de Uso

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://api.wappfy.com.br/api/my-session/groups/120363XXXXX@g.us/picture
  ```

  ```javascript JavaScript theme={null}
  const session = 'my-session';
  const groupId = '120363XXXXX@g.us';
  const response = await fetch(`https://api.wappfy.com.br/api/${session}/groups/${groupId}/picture`);
  const data = await response.json();
  console.log(data.url);
  ```

  ```python Python theme={null}
  import requests

  session = 'my-session'
  group_id = '120363XXXXX@g.us'
  response = requests.get(f'https://api.wappfy.com.br/api/{session}/groups/{group_id}/picture')
  data = response.json()
  print(data['url'])
  ```
</CodeGroup>


## OpenAPI

````yaml viewer.json get /api/{session}/groups/{id}/picture
openapi: 3.1.0
info:
  title: Wappfy - WhatsApp HTTP API
  version: '2.0'
  contact: {}
servers:
  - url: https://{host}
    description: Servidor Customizável
    variables:
      host:
        default: api.wappfy.com.br
        description: 'URL do servidor (ex: api.wappfy.com.br ou seu-servidor.com)'
security:
  - api_key: []
tags:
  - name: 🖥️ Sessions
    description: >-
      Controlar sessões do WhatsApp (contas) (Control WhatsApp sessions
      (accounts))
  - name: 🔑 Auth
    description: Autenticação
  - name: 🆔 Profile
    description: Informações do seu perfil
  - name: 🖼️ Screenshot
    description: Obter captura de tela do WhatsApp e mostrar código QR
  - name: 📤 Chatting
    description: Métodos de conversação
  - name: 📢 Channels
    description: Métodos de canais (newsletters) (Channels (newsletters) methods)
  - name: 🟢 Status
    description: Métodos de status (aka stories) (Status (aka stories) methods)
  - name: 💬 Chats
    description: Métodos de conversas
  - name: 👤 Contacts
    description: >-
      Métodos de contatos. Use número de telefone (sem +) ou número de telefone
      e `@c.us` no final como `contactId`. Ex: `12312312310` OU
      `12312312310@c.us` (Contacts methods.<br>
                      Use phone number (without +) or phone number and `@c.us` at the end as `contactId`.<br>
                      'E.g: `12312312310` OR `12312312310@c.us`<br>)
  - name: 👥 Groups
    description: Métodos de grupos (Groups methods).<br>
  - name: ✅ Presence
    description: Informações de presença
  - name: 📅 Events
    description: Mensagem de Evento
  - name: 🏷️ Labels
    description: Etiquetas - disponível apenas para contas WhatsApp Business
  - name: 🔍 Observability
    description: Outros métodos
  - name: 🗄️ Storage
    description: Métodos de armazenamento
externalDocs:
  description: Wappfy - WhatsApp HTTP API
  url: https://wappfy.com.br/
paths:
  /api/{session}/groups/{id}/picture:
    get:
      tags:
        - 👥 Groups
      summary: Obter foto do grupo
      description: O parâmetro {session} deve ser o instanceName da sessão.
      operationId: GroupsController_getChatPicture
      parameters:
        - name: id
          required: true
          in: path
          description: ID do Grupo
          example: 123123123@g.us
          schema:
            type: string
        - name: refresh
          required: false
          in: query
          example: false
          description: >-
            Atualizar a foto do servidor (cache de 24h por padrão). Não atualize
            se não for necessário, você pode ter erro de limite de taxa (Refresh
            the picture from the server (24h cache by default). Do not refresh
            if not needed, you can get rate limit error)
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatPictureResponse'
      security:
        - api_key: []
components:
  schemas:
    ChatPictureResponse:
      type: object
      properties:
        url:
          type: string
      required:
        - url
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: apikey
      description: Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)

````