DocumentaciónReferencia APIListar herramientas durante llamada
    GETDisponible

    Listar herramientas durante llamada

    Operación autenticada de la API de BeepCall.

    https://app.beepcall.ai/api/user/tools

    Parámetros

    Authorization*headerBearer tokenClave de API de BeepCall.

    * Obligatorio

    Ejemplo de solicitud

    curl -X GET "https://app.beepcall.ai/api/user/tools" \
      -H "Authorization: Bearer YOUR_API_KEY"

    Respuesta

    json
    [
      {
        "id": 1,
        "name": "get_weather",
        "description": "Use this tool to get the current weather in a specific city. Call this when the customer asks about weather conditions.",
        "type": "http",
        "endpoint": "https://api.openweathermap.org/data/2.5/weather?city={city}",
        "method": "GET",
        "body_format": "json",
        "timeout": 10,
        "headers": [
          {
            "name": "Content-Type",
            "value": "application/json"
          },
          {
            "name": "Authorization",
            "value": "Bearer sk_..."
          }
        ],
        "static_fields": [],
        "schema": [
          {
            "name": "city",
            "type": "string",
            "description": "The city name to get weather for",
            "required": true
          },
          {
            "name": "days",
            "type": "number",
            "description": "Number of forecast days",
            "required": false
          }
        ],
        "created_at": "2025-10-10T12:00:00.000000Z",
        "updated_at": "2025-10-10T12:00:00.000000Z"
      },
      {
        "id": 2,
        "name": "send_notification",
        "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
        "type": "http",
        "endpoint": "https://api.yourcompany.com/notifications/send",
        "method": "POST",
        "body_format": "json",
        "timeout": 15,
        "headers": [
          {
            "name": "Content-Type",
            "value": "application/json"
          }
        ],
        "static_fields": [
          {
            "key": "caller",
            "value": "{{customer_phone}}"
          }
        ],
        "schema": [
          {
            "name": "message",
            "type": "string",
            "description": "The notification message to send",
            "required": true
          },
          {
            "name": "send_sms",
            "type": "boolean",
            "description": "Whether to also send SMS notification",
            "required": false
          }
        ],
        "created_at": "2025-10-09T14:30:00.000000Z",
        "updated_at": "2025-10-10T09:15:00.000000Z"
      }
    ]

    Errores habituales