Listar acciones durante la llamada
curl --request GET \
--url https://app.famulor.de/api/user/tools \
--header 'Accept: <accept>' \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>'import requests
url = "https://app.famulor.de/api/user/tools"
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>",
"Accept": "<accept>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
Authorization: '<authorization>',
'Content-Type': '<content-type>',
Accept: '<accept>'
}
};
fetch('https://app.famulor.de/api/user/tools', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.de/api/user/tools",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Accept: <accept>",
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.de/api/user/tools"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "<content-type>")
req.Header.Add("Accept", "<accept>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.famulor.de/api/user/tools")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.header("Accept", "<accept>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/tools")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request["Accept"] = '<accept>'
response = http.request(request)
puts response.read_body{
"data": [
{
"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"
}
]
}
Acciones durante la llamada
Listar acciones durante la llamada
Recupera todas las acciones durante la llamada disponibles en tu cuenta de Famulor a través de la API. Útil para inventariar, depurar y vincular acciones a los asistentes de voz de IA.
GET
/
api
/
user
/
tools
Listar acciones durante la llamada
curl --request GET \
--url https://app.famulor.de/api/user/tools \
--header 'Accept: <accept>' \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>'import requests
url = "https://app.famulor.de/api/user/tools"
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>",
"Accept": "<accept>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
Authorization: '<authorization>',
'Content-Type': '<content-type>',
Accept: '<accept>'
}
};
fetch('https://app.famulor.de/api/user/tools', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.de/api/user/tools",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Accept: <accept>",
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.de/api/user/tools"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "<content-type>")
req.Header.Add("Accept", "<accept>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.famulor.de/api/user/tools")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.header("Accept", "<accept>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/tools")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request["Accept"] = '<accept>'
response = http.request(request)
puts response.read_body{
"data": [
{
"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"
}
]
}
API de Famulor 1.0 (legado). Esta página se aplica únicamente a Famulor 1.0 (
app.famulor.de) y se conserva por compatibilidad. Para la plataforma actual, usa la referencia de la API de Famulor 2.0.Encabezados
string
requerido
Token Bearer para la autenticación
string
requerido
Debe ser
application/jsonstring
requerido
Debe ser
application/jsonCampos de respuesta
array
Array de acciones durante la llamada
Mostrar Propiedades
Mostrar Propiedades
integer
El identificador único de la acción durante la llamada
string
El nombre de la acción durante la llamada
string
Explicación detallada de cuándo y cómo debe usar la IA esta acción durante la llamada
string
Tipo de acción durante la llamada:
http o automationstring
La URL del endpoint de la API que se llamará
string
Método HTTP (GET, POST, PUT, PATCH, DELETE)
string
Codificación del cuerpo de la solicitud:
json o forminteger
Tiempo de espera de la solicitud en segundos (1-30)
array
array
array
Parámetros que la IA extraerá y enviará al endpoint
string
Marca de tiempo ISO 8601 de cuándo se creó la acción durante la llamada
string
Marca de tiempo ISO 8601 de cuándo se actualizó por última vez la acción durante la llamada
{
"data": [
{
"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"
}
]
}
Asignar acciones durante la llamada a los asistentes
Para usar estas acciones durante la llamada con asistentes, consulta:- Crear asistente — Vincula acciones durante la llamada usando el parámetro
tool_ids - Actualizar asistente — Gestiona las asignaciones de acciones durante la llamada usando el parámetro
tool_ids
¿Necesitas todo un conjunto de herramientas en lugar de crear acciones HTTP una por una? Conecta un servidor MCP externo: las herramientas se descubren automáticamente. Consulta Servidores MCP.