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

# Presença

> Envia atualização de presença (online, digitando, etc)

Envia atualizações de presença para um chat específico, como "online", "digitando" ou "gravando áudio".

## Request Body

<ParamField body="sessionId" type="string" required>
  ID da sessão WhatsApp.
</ParamField>

<ParamField body="type" type="string" required>
  Tipo de presença.

  **Valores:**

  * `available` - Online
  * `unavailable` - Offline
  * `composing` - Digitando
  * `recording` - Gravando áudio
  * `paused` - Parou de digitar
</ParamField>

<ParamField body="toJid" type="string">
  JID do destinatário (opcional, para presença específica de chat).
</ParamField>

## Resposta

<ResponseField name="success" type="boolean">
  Se a presença foi enviada.
</ResponseField>

<ResponseField name="type" type="string">
  Tipo de presença enviada.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  # Mostrar "digitando" para um contato
  curl -X POST "https://api.oxenty.api.br/api/contacts/presence" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "type": "composing",
      "toJid": "5511999999999@s.whatsapp.net"
    }'
  ```

  ```typescript TypeScript theme={"system"}
  // Mostrar "digitando"
  await client.contacts.sendPresence({
    sessionId: '550e8400-e29b-41d4-a716-446655440000',
    type: 'composing',
    toJid: '5511999999999@s.whatsapp.net',
  });

  // Parar de mostrar "digitando"
  await client.contacts.sendPresence({
    sessionId: '550e8400-e29b-41d4-a716-446655440000',
    type: 'paused',
    toJid: '5511999999999@s.whatsapp.net',
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "success": true,
    "type": "composing",
    "toJid": "5511999999999@s.whatsapp.net"
  }
  ```
</ResponseExample>

***

## Inscrever para Receber Presença

<api method="POST" path="/api/contacts/presence/subscribe" />

Inscreve-se para receber atualizações de presença de um contato via webhook.

```bash theme={"system"}
curl -X POST "https://api.oxenty.api.br/api/contacts/presence/subscribe" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "jid": "5511999999999@s.whatsapp.net"
  }'
```

<Tip>
  Use `composing` antes de enviar uma mensagem para simular comportamento humano e melhorar a experiência do usuário.
</Tip>