Listar llamadas
curl --request GET \
--url https://app.famulor.de/api/user/callsimport requests
url = "https://app.famulor.de/api/user/calls"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.famulor.de/api/user/calls', 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/calls",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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/calls"
req, _ := http.NewRequest("GET", url, nil)
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/calls")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/calls")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 123456,
"assistant_name": "Sales Assistant",
"campaign_name": "Neukundenakquise Q1 2024",
"type": "outbound",
"duration": 180,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4915123456789",
"status": "completed",
"transcript": [
{
"text": "Hallo, mein Name ist Maximilian, ich melde mich im Auftrag eines IT-Unternehmens.",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055268.525861
},
{
"text": "Hallo?",
"type": "transcript",
"sender": "human",
"timestamp": 1754055272.069057
}
],
"variables": {
"customer_name": "John"
},
"evaluation": [
{
"name": "status",
"type": "bool",
"value": true,
"description": "Whether the call objective was achieved or not."
},
{
"name": "summary",
"type": "string",
"value": "Connected to the customer, obtained name of the person responsible for IT.",
"description": "Call summary in a few words."
}
],
"webhook_response": {
"crm_updated": true,
"lead_score": 75
},
"carrier_cost": "0.08000000",
"total_cost": "0.12000000",
"answered_by": "human",
"recording_url": "https://recordings.famulor.de/call-123456.mp3",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:33:00Z"
},
{
"id": 123457,
"assistant_name": "Support Assistant",
"campaign_name": null,
"type": "inbound",
"duration": 120,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4917123456789",
"status": "ended_by_customer",
"transcript": [
{
"text": "Kunde: Hallo, ich habe eine Frage zu meinem Konto.",
"type": "transcript",
"sender": "human",
"timestamp": 1754055300.123456
},
{
"text": "Gerne helfe ich Ihnen dabei. Was kann ich für Sie tun?",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055302.789012
}
],
"variables": {
"issue_resolved": true,
"satisfaction_rating": 9
},
"evaluation": [
{
"name": "issue_resolved",
"type": "bool",
"value": true,
"description": "Whether the customer's issue was resolved."
},
{
"name": "satisfaction_rating",
"type": "integer",
"value": 9,
"description": "Customer satisfaction rating from 1-10."
}
],
"webhook_response": null,
"carrier_cost": "0.05000000",
"total_cost": "0.08000000",
"answered_by": "human",
"recording_url": null,
"created_at": "2024-01-15T14:20:00Z",
"updated_at": "2024-01-15T14:22:00Z"
}
],
"current_page": 1,
"first_page_url": "https://app.famulor.de/api/user/calls?page=1",
"from": 1,
"last_page": 4,
"last_page_url": "https://app.famulor.de/api/user/calls?page=4",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.famulor.de/api/user/calls?page=1",
"label": "1",
"active": true
}
],
"next_page_url": "https://app.famulor.de/api/user/calls?page=2",
"path": "https://app.famulor.de/api/user/calls",
"per_page": 15,
"prev_page_url": null,
"to": 15,
"total": 52
}
Llamadas
Listar llamadas
Lista todas las llamadas del usuario autenticado con opciones de filtrado
GET
/
api
/
user
/
calls
Listar llamadas
curl --request GET \
--url https://app.famulor.de/api/user/callsimport requests
url = "https://app.famulor.de/api/user/calls"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.famulor.de/api/user/calls', 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/calls",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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/calls"
req, _ := http.NewRequest("GET", url, nil)
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/calls")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/calls")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 123456,
"assistant_name": "Sales Assistant",
"campaign_name": "Neukundenakquise Q1 2024",
"type": "outbound",
"duration": 180,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4915123456789",
"status": "completed",
"transcript": [
{
"text": "Hallo, mein Name ist Maximilian, ich melde mich im Auftrag eines IT-Unternehmens.",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055268.525861
},
{
"text": "Hallo?",
"type": "transcript",
"sender": "human",
"timestamp": 1754055272.069057
}
],
"variables": {
"customer_name": "John"
},
"evaluation": [
{
"name": "status",
"type": "bool",
"value": true,
"description": "Whether the call objective was achieved or not."
},
{
"name": "summary",
"type": "string",
"value": "Connected to the customer, obtained name of the person responsible for IT.",
"description": "Call summary in a few words."
}
],
"webhook_response": {
"crm_updated": true,
"lead_score": 75
},
"carrier_cost": "0.08000000",
"total_cost": "0.12000000",
"answered_by": "human",
"recording_url": "https://recordings.famulor.de/call-123456.mp3",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:33:00Z"
},
{
"id": 123457,
"assistant_name": "Support Assistant",
"campaign_name": null,
"type": "inbound",
"duration": 120,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4917123456789",
"status": "ended_by_customer",
"transcript": [
{
"text": "Kunde: Hallo, ich habe eine Frage zu meinem Konto.",
"type": "transcript",
"sender": "human",
"timestamp": 1754055300.123456
},
{
"text": "Gerne helfe ich Ihnen dabei. Was kann ich für Sie tun?",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055302.789012
}
],
"variables": {
"issue_resolved": true,
"satisfaction_rating": 9
},
"evaluation": [
{
"name": "issue_resolved",
"type": "bool",
"value": true,
"description": "Whether the customer's issue was resolved."
},
{
"name": "satisfaction_rating",
"type": "integer",
"value": 9,
"description": "Customer satisfaction rating from 1-10."
}
],
"webhook_response": null,
"carrier_cost": "0.05000000",
"total_cost": "0.08000000",
"answered_by": "human",
"recording_url": null,
"created_at": "2024-01-15T14:20:00Z",
"updated_at": "2024-01-15T14:22:00Z"
}
],
"current_page": 1,
"first_page_url": "https://app.famulor.de/api/user/calls?page=1",
"from": 1,
"last_page": 4,
"last_page_url": "https://app.famulor.de/api/user/calls?page=4",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.famulor.de/api/user/calls?page=1",
"label": "1",
"active": true
}
],
"next_page_url": "https://app.famulor.de/api/user/calls?page=2",
"path": "https://app.famulor.de/api/user/calls",
"per_page": 15,
"prev_page_url": null,
"to": 15,
"total": 52
}
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.Parámetros de consulta
string
Filtra las llamadas por estado. Valores posibles:
initiated, ringing, busy, in-progress, ended, completed, ended_by_customer, ended_by_assistant, no-answer, failedstring
Filtra las llamadas por tipo. Valores posibles:
inbound, outbound, webstring
Filtra las llamadas por el número de teléfono del cliente
integer
Filtra las llamadas por ID de asistente
integer
Filtra las llamadas por ID de campaña
string
Filtra las llamadas desde esta fecha (formato YYYY-MM-DD)
string
Filtra las llamadas hasta esta fecha (formato YYYY-MM-DD)
integer
Número de llamadas por página (1-100, por defecto: 15)
integer
Número de página (por defecto: 1)
Campos de respuesta
array
Array de llamadas
Mostrar Propiedades de la llamada
Mostrar Propiedades de la llamada
integer
El identificador único de la llamada
string
El nombre del asistente que gestionó la llamada
string
El nombre de la campaña a la que pertenece esta llamada (si corresponde)
string
El tipo de la llamada (inbound, outbound o web)
integer
La duración de la llamada en segundos
string
El número de teléfono utilizado por el asistente
string
El número de teléfono del cliente
string
El estado actual de la llamada
array
La transcripción de la conversación de la llamada como un array de objetos que contienen text, type, sender y timestamp
object
Variables recopiladas durante la llamada
array
Datos de evaluación del rendimiento de la llamada como un array de objetos con name, type, value y description
object
Respuesta de los webhooks configurados
string
El coste cobrado por el proveedor de telefonía para esta llamada
string
El coste total de la llamada, incluidas todas las comisiones
string
Quién respondió la llamada (human, machine o unknown)
string
URL de la grabación de la llamada (si está disponible y habilitada)
string
Fecha y hora de creación de la llamada
string
Fecha y hora de la última actualización de la llamada
integer
El número de página actual
integer
Número de elementos por página
integer
Número total de llamadas que coinciden con los criterios
integer
El número de la última página
string
URL de la primera página
string
URL de la última página
string
URL de la página siguiente, o
nullstring
URL de la página anterior, o
nullstring
Ruta base de paginación
{
"data": [
{
"id": 123456,
"assistant_name": "Sales Assistant",
"campaign_name": "Neukundenakquise Q1 2024",
"type": "outbound",
"duration": 180,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4915123456789",
"status": "completed",
"transcript": [
{
"text": "Hallo, mein Name ist Maximilian, ich melde mich im Auftrag eines IT-Unternehmens.",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055268.525861
},
{
"text": "Hallo?",
"type": "transcript",
"sender": "human",
"timestamp": 1754055272.069057
}
],
"variables": {
"customer_name": "John"
},
"evaluation": [
{
"name": "status",
"type": "bool",
"value": true,
"description": "Whether the call objective was achieved or not."
},
{
"name": "summary",
"type": "string",
"value": "Connected to the customer, obtained name of the person responsible for IT.",
"description": "Call summary in a few words."
}
],
"webhook_response": {
"crm_updated": true,
"lead_score": 75
},
"carrier_cost": "0.08000000",
"total_cost": "0.12000000",
"answered_by": "human",
"recording_url": "https://recordings.famulor.de/call-123456.mp3",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:33:00Z"
},
{
"id": 123457,
"assistant_name": "Support Assistant",
"campaign_name": null,
"type": "inbound",
"duration": 120,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4917123456789",
"status": "ended_by_customer",
"transcript": [
{
"text": "Kunde: Hallo, ich habe eine Frage zu meinem Konto.",
"type": "transcript",
"sender": "human",
"timestamp": 1754055300.123456
},
{
"text": "Gerne helfe ich Ihnen dabei. Was kann ich für Sie tun?",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055302.789012
}
],
"variables": {
"issue_resolved": true,
"satisfaction_rating": 9
},
"evaluation": [
{
"name": "issue_resolved",
"type": "bool",
"value": true,
"description": "Whether the customer's issue was resolved."
},
{
"name": "satisfaction_rating",
"type": "integer",
"value": 9,
"description": "Customer satisfaction rating from 1-10."
}
],
"webhook_response": null,
"carrier_cost": "0.05000000",
"total_cost": "0.08000000",
"answered_by": "human",
"recording_url": null,
"created_at": "2024-01-15T14:20:00Z",
"updated_at": "2024-01-15T14:22:00Z"
}
],
"current_page": 1,
"first_page_url": "https://app.famulor.de/api/user/calls?page=1",
"from": 1,
"last_page": 4,
"last_page_url": "https://app.famulor.de/api/user/calls?page=4",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.famulor.de/api/user/calls?page=1",
"label": "1",
"active": true
}
],
"next_page_url": "https://app.famulor.de/api/user/calls?page=2",
"path": "https://app.famulor.de/api/user/calls",
"per_page": 15,
"prev_page_url": null,
"to": 15,
"total": 52
}
Páginas relacionadas: Introducción y Guía de autenticación, y Ejemplos de integración de la API.
⌘I