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

# Rechazar una llamada entrante

> Rechazar programáticamente una llamada entrante específica. Este endpoint permite el rechazo selectivo
basado en la lógica de tu aplicación (por ejemplo, reglas de tiempo del día, listas blancas de llamadas, agente disponible).

La llamada debe seguir sonando — el rechazo fallará si la llamada ya ha finalizado o si ha sido respondida.

Esto es complementario a la característica auto-reject (`WHATSAPP_AUTO_REJECT_CALL=true`) que rechaza
todas las llamadas entrantes globalmente. Utilice esta API para un control de grano fino.

**Campos requeridos desde webhook:**
- `caller_jid`: Usa `payload.from` desde el evento webhook `call.offer`
- `call_id`: Usa `payload.call_id` desde el evento webhook `call.offer`




## OpenAPI

````yaml /es/openapi.yml post /call/reject
openapi: 3.0.0
info:
  title: Multidispositivo API de WhatsApp
  version: 9.7.0
  description: >
    Esta API se utiliza para enviar whatsapp a través de API.


    El panel web es un proyecto separado (gowa-ui); el servidor descarga su
    último recurso de versión

    y lo sirve en `/` (o devuelve un banner JSON cuando

    APP_UI_ENABLED=false).


    Ámbito del dispositivo:

    - Envía `X-Device-Id` en todas las llamadas REST con ámbito dispositivo.

    - WebSocket: conectar a `/ws?device_id=<id>`.

    - WebSocket auth (cuando la autenticación básica está habilitada): los
    navegadores no pueden establecer un encabezado
      de autorización en conexiones WebSocket, así que también pase
      `&authorization=<base64(user:pass)>` en la cadena de consulta. Usa TLS en producciónformat@@0
      ya que la credencial es visible en la URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Conexión inicial al servidor de Whatsapp
  - name: device
    description: Gestión de dispositivos para soporte multidispositivo
  - name: user
    description: Obteniendo información
  - name: send
    description: Enviar mensaje (Texto/Imágen/Archivo/Video).
  - name: message
    description: Manipulación de mensajes (revocar/react/actualizar).
  - name: call
    description: Gestión de llamadas (rechazar llamadas entrantes)
  - name: chat
    description: Chats de chat y mensajería
  - name: group
    description: Ajuste de grupo
  - name: newsletter
    description: configuración del boletín de noticias
  - name: chatwoot
    description: Integración de Chatwoot para soporte al cliente
paths:
  /call/reject:
    post:
      tags:
        - call
      summary: Rechazar una llamada entrante
      description: >
        Rechazar programáticamente una llamada entrante específica. Este
        endpoint permite el rechazo selectivo

        basado en la lógica de tu aplicación (por ejemplo, reglas de tiempo del
        día, listas blancas de llamadas, agente disponible).


        La llamada debe seguir sonando — el rechazo fallará si la llamada ya ha
        finalizado o si ha sido respondida.


        Esto es complementario a la característica auto-reject
        (`WHATSAPP_AUTO_REJECT_CALL=true`) que rechaza

        todas las llamadas entrantes globalmente. Utilice esta API para un
        control de grano fino.


        **Campos requeridos desde webhook:**

        - `caller_jid`: Usa `payload.from` desde el evento webhook `call.offer`

        - `call_id`: Usa `payload.call_id` desde el evento webhook `call.offer`
      operationId: rejectCall
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - caller_jid
                - call_id
              properties:
                caller_jid:
                  type: string
                  example: 628987654321@s.whatsapp.net
                  description: JID del llamador (de webhook `payload.from`)
                call_id:
                  type: string
                  example: ABC123DEF456
                  description: >-
                    Identificador de llamada único (de webhook
                    `payload.call_id`)
      responses:
        '200':
          description: Llamada rechazada con éxito
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
        '400':
          description: Solicitud errónea (campos faltantes o no válidos)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: >-
            Error interno del servidor (llamada ya finalizada, no conectada,
            etc.)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Identificador de dispositivo para soporte multidispositivo. Requerido
        cuando se registran múltiples dispositivos.

        Si sólo se registra un dispositivo, se utilizará como el valor
        predeterminado.

        También se puede proporcionar como parámetro de consulta `device_id`.
      schema:
        type: string
        example: my-device-id
  schemas:
    GenericResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success
        results:
          type: string
          example: null
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: Código de estado HTTP
        message:
          type: string
          example: field cannot be blank
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: Error
        message:
          type: string
          example: you are not loggin
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Referencia API](https://gowa-docs.mintlify.site/es/api-reference/introduction.md)
- [Integración de Chatwoot](https://gowa-docs.mintlify.site/es/integrations/chatwoot.md)
- [Referencia de configuración](https://gowa-docs.mintlify.site/es/configuration.md)
- [Webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md)
- [Manejo de medios](https://gowa-docs.mintlify.site/es/examples/media-handling.md)


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