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

# Responder no direct

> Abra uma conversa no Direct a partir de um comentário.

Envia uma mensagem no Direct para quem comentou, usando o mesmo endpoint de envio de mensagens, mas endereçando o **comentário** em vez da pessoa:

```json theme={null}
"recipient": { "comment_id": "17800000000000001" }
```

A Meta resolve quem é o autor. Você não precisa conhecer o IGSID para enviar a primeira mensagem.

## Uma por comentário

Cada comentário permite **uma única** resposta no direct. A segunda tentativa é recusada:

```json theme={null}
{
  "error": {
    "message": "O comentário ao qual você está tentando responder já tem uma resposta.",
    "type": "IGApiException",
    "code": 100,
    "error_subcode": 2534023
  }
}
```

O prazo é de **7 dias** a partir do comentário. Em comentários de transmissão ao vivo, apenas durante a transmissão.

## Limite por hora

A Meta permite **750 respostas privadas por hora** por conta profissional, somando comentários de publicações e reels. Em comentários de transmissão ao vivo o limite é outro, de 100 por segundo.

> [!WARNING]
>
> O limite da Meta é mais restritivo que o da Datafy. São 750 por hora, equivalentes a 12,5 por minuto, contra 4.800 por minuto no limite de envio da Datafy. Uma integração pode exceder o limite da Meta sem atingir o da Datafy.

Quando o limite é atingido, a Meta recusa e a Datafy repassa a resposta dela. **Não há fila nem retentativa**: a mensagem não sai e cabe à sua integração decidir o que fazer. Para volume alto, distribua os envios ao longo da hora em vez de disparar em rajada.

## Continuar a conversa

A resposta do envio traz o `recipient_id`, que é o IGSID da pessoa:

```json theme={null}
{
  "recipient_id": "1000000000000002",
  "message_id": "aWdfZAG1faXRlbTo......"
}
```

Guarde esse valor. As mensagens seguintes saem pelo [envio normal](https://developers.datafyapi.com.br/api-reference/instagram/mensagens/enviar-texto.md), com `recipient.id`, e passam a valer pela [janela de 24 horas](https://developers.datafyapi.com.br/api-reference/instagram/mensagens/introducao.md#janela-de-24-horas), contada a partir da resposta da pessoa.

> [!WARNING]
>
> Uma automação que manda a primeira mensagem por `comment_id` e tenta mandar a segunda pelo mesmo caminho vai falhar. A segunda precisa ser endereçada por `recipient.id`.


## OpenAPI

````yaml api-reference/instagram/specs/comentarios-dm.json POST /ig/me/messages
openapi: 3.1.0
info:
  title: Datafy API — Responder no direct
  version: 1.0.0
servers:
  - url: https://cloud.datafyapi.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /ig/me/messages:
    post:
      summary: Responder no direct
      operationId: igRespostaPrivada
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - recipient
                - message
              properties:
                recipient:
                  type: object
                  required:
                    - comment_id
                  description: Endereça o COMENTÁRIO, não a pessoa.
                  properties:
                    comment_id:
                      type: string
                      description: ID do comentário que origina a conversa.
                      example: '17800000000000001'
                message:
                  type: object
                  required:
                    - text
                  properties:
                    text:
                      type: string
                      description: Texto da mensagem.
                      example: Oi! Respondendo seu comentário por aqui.
            example:
              recipient:
                comment_id: '17800000000000001'
              message:
                text: Oi! Respondendo seu comentário por aqui.
      responses:
        '200':
          description: Operação aceita.
          content:
            application/json:
              example:
                recipient_id: '1000000000000002'
                message_id: aWdfZAG1faXRlbTo......
        '400':
          description: O comentário já recebeu uma resposta privada, ou passou de 7 dias.
          content:
            application/json:
              example:
                error:
                  message: >-
                    O comentário ao qual você está tentando responder já tem uma
                    resposta.
                  type: IGApiException
                  code: 100
                  error_subcode: 2534023
        '401':
          description: Token ausente ou inválido.
          content:
            application/json:
              example:
                statusCode: 401
                message: Token inválido ou não encontrado.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token do canal do Instagram, gerado no painel da Datafy. Formato:
        `sk_live_xxx`.

````

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