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

# Iniciar llamada saliente

> Lanza una llamada saliente usando un agente IA. Requiere saldo disponible.



## OpenAPI

````yaml /openapi.json post /api/v1/vicky/calls/outbound
openapi: 3.0.0
info:
  title: WeKall API
  description: >-
    API de WeKall para integraciones externas y automatizacion.


    Conecta tus sistemas con la plataforma WeKall para gestionar agentes de voz
    IA, llamadas, campanas, mensajeria WhatsApp y mas.


    ## Autenticacion


    Usa el endpoint `POST /api/v1/auth/token` con tus credenciales (`client_id`
    + `client_secret`) para obtener un access token. Incluye el token en el
    header `Authorization: Bearer {token}` de cada request.


    ## Productos disponibles


    - **Vicky AI** -- Agentes de voz IA, llamadas, campanas, grabaciones,
    reportes, billing

    - **Messenger Hub** -- WhatsApp, broadcast transaccional, chats, contactos

    - **Notes AI** -- Transcripcion y resumen

    - **Contact Center** -- Gestion de agentes humanos (proximamente)

    - **Business Phone** -- Telefonia cloud PBX (proximamente)


    ## Rate limiting


    100 requests/minuto por IP. El endpoint de autenticacion tiene un limite de
    10 requests/minuto.
  version: '1.0'
  contact: {}
servers:
  - url: https://apis.wekall.co
    description: Produccion
  - url: http://localhost:4001
    description: Local (desarrollo)
security: []
tags:
  - name: Auth
    description: Autenticacion y generacion de tokens
  - name: Vicky AI
    description: Agentes de voz IA, llamadas, campanas, grabaciones, reportes y billing
  - name: Messenger Hub
    description: WhatsApp, broadcast transaccional, chats y contactos
  - name: Notes AI
    description: >-
      Transcripciones de reuniones, conversaciones por vendedor y reuniones
      programadas
paths:
  /api/v1/vicky/calls/outbound:
    post:
      tags:
        - Vicky AI
      summary: Iniciar llamada saliente
      description: >-
        Lanza una llamada saliente usando un agente IA. Requiere saldo
        disponible.
      operationId: VickyController_launchOutboundCall
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LaunchOutboundCallDto'
      responses:
        '201':
          description: Llamada iniciada
        '400':
          description: Datos invalidos o agente no encontrado
        '409':
          description: Sin saldo disponible
      security:
        - bearer: []
components:
  schemas:
    LaunchOutboundCallDto:
      type: object
      properties:
        agentId:
          type: string
          example: 6a0e1701ef0ddceeedc18084
          description: ID del agente que realizara la llamada
        toNumber:
          type: string
          example: '+573001234567'
          description: Numero de telefono destino (formato E.164)
        conversation_initiation_client_data:
          type: object
          description: Variables dinamicas para la conversacion
          example:
            nombre: Juan
            deuda: '150000'
      required:
        - agentId
        - toNumber
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Token obtenido desde POST /api/v1/auth/token

````