# Obter perfis detalhados de bots

`POST /bots/profiles`

Pasta: **Bots**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Obter perfis detalhados de bots

Busca metadados detalhados de perfis de bots do Meta AI (nome, descrição, avatar), opcionalmente filtrando por persona. Use após listar bots em `GET /bots` para obter detalhes de exibição.

## Endpoint

`POST {{baseUrl}}/bots/profiles`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `bots` | array<object> | Sim | Lista de bots a consultar. Não pode ser vazia. |
| `bots[].jid` | string | Sim* | JID do bot (`...@bot`). Aceita alias `bot_jid`. |
| `bots[].bot_jid` | string | Sim* | Alias de `jid` por item. |
| `bots[].persona_id` | string | Não | Filtra por persona específica do bot. Aceita alias `personaId`. |

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/bots/profiles' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "bots": [
    { "jid": "867051314767696@bot" }
  ]
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "profiles": [
    { "jid": "867051314767696@bot", "name": "Meta AI", "description": "Assistente de IA da Meta" }
  ]
}
```

## Erros comuns

- `401 Unauthorized`: o header `token` não foi enviado ou é inválido.
- `400 Bad Request`: o JSON está malformado ou contém um identificador inválido.
- `500 Internal Server Error`: a conexão com o WhatsApp falhou ou a operação foi recusada.

## Observações

* Cada item de `bots` precisa de `jid` (ou `bot_jid`). Liste bots disponíveis em `GET /bots`.

## Corpo (exemplo)

```json
{
  "bots": [
    { "jid": "867051314767696@bot" }
  ]
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/bots/profiles" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "bots": [
    { "jid": "867051314767696@bot" }
  ]
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=bots/obter-perfis-detalhados-de-bots)