Comprar número de teléfono
curl --request POST \
--url https://app.famulor.de/api/user/phone-numbers/purchase \
--header 'Content-Type: application/json' \
--data '
{
"phone_number": "<string>"
}
'import requests
url = "https://app.famulor.de/api/user/phone-numbers/purchase"
payload = { "phone_number": "<string>" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({phone_number: '<string>'})
};
fetch('https://app.famulor.de/api/user/phone-numbers/purchase', 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/phone-numbers/purchase",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone_number' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.de/api/user/phone-numbers/purchase"
payload := strings.NewReader("{\n \"phone_number\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.famulor.de/api/user/phone-numbers/purchase")
.header("Content-Type", "application/json")
.body("{\n \"phone_number\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/phone-numbers/purchase")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone_number\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"message": "Phone number purchased successfully.",
"data": {
"id": 123,
"phone_number": "+14155551234",
"country_code": "US",
"type": "normal",
"sms_capable": true
}
}
{
"error": "This phone number is already in use."
}
{
"error": "This phone number is not available for purchase. Please search for available numbers first."
}
{
"error": "No payment method found. Please add a payment method to your account."
}
{
"error": "Payment failed. Please update your payment method."
}
{
"error": "Unable to parse phone number. Please provide a valid E.164 format number."
}
{
"error": "Failed to purchase phone number from provider. Please contact support."
}
Números de teléfono
Comprar número de teléfono
Compra un número de teléfono dedicado en Famulor a través de la API. Adquiere números locales, móviles o de tarifa gratuita para llamadas entrantes o salientes del agente de voz de IA.
POST
/
api
/
user
/
phone-numbers
/
purchase
Comprar número de teléfono
curl --request POST \
--url https://app.famulor.de/api/user/phone-numbers/purchase \
--header 'Content-Type: application/json' \
--data '
{
"phone_number": "<string>"
}
'import requests
url = "https://app.famulor.de/api/user/phone-numbers/purchase"
payload = { "phone_number": "<string>" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({phone_number: '<string>'})
};
fetch('https://app.famulor.de/api/user/phone-numbers/purchase', 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/phone-numbers/purchase",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone_number' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.de/api/user/phone-numbers/purchase"
payload := strings.NewReader("{\n \"phone_number\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.famulor.de/api/user/phone-numbers/purchase")
.header("Content-Type", "application/json")
.body("{\n \"phone_number\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/phone-numbers/purchase")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone_number\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"message": "Phone number purchased successfully.",
"data": {
"id": 123,
"phone_number": "+14155551234",
"country_code": "US",
"type": "normal",
"sms_capable": true
}
}
{
"error": "This phone number is already in use."
}
{
"error": "This phone number is not available for purchase. Please search for available numbers first."
}
{
"error": "No payment method found. Please add a payment method to your account."
}
{
"error": "Payment failed. Please update your payment method."
}
{
"error": "Unable to parse phone number. Please provide a valid E.164 format number."
}
{
"error": "Failed to purchase phone number from provider. Please contact support."
}
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.Debes tener un método de pago válido registrado antes de poder comprar un número de teléfono. La compra crea una suscripción mensual que se renueva automáticamente.
Cuerpo de la solicitud
string
requerido
El número de teléfono que se va a comprar, en formato E.164 (p. ej., +14155551234). Debe ser un número devuelto por el endpoint de búsqueda.
Campos de respuesta
string
Mensaje de éxito
object
Los datos del número de teléfono comprado
Cómo funciona
- Buscar: primero usa el endpoint de búsqueda para encontrar números disponibles
- Comprar: envía el número de teléfono deseado a este endpoint
- Procesamiento automático: la plataforma:
- Valida que el número siga disponible
- Determina el precio correcto según el país
- Crea una suscripción mensual en tu método de pago
- Aprovisiona el número con nuestro proveedor de telefonía
- Crea el registro del número de teléfono en tu cuenta
Las compras de números de teléfono no son reembolsables. La suscripción continuará hasta que liberes el número.
{
"message": "Phone number purchased successfully.",
"data": {
"id": 123,
"phone_number": "+14155551234",
"country_code": "US",
"type": "normal",
"sms_capable": true
}
}
{
"error": "This phone number is already in use."
}
{
"error": "This phone number is not available for purchase. Please search for available numbers first."
}
{
"error": "No payment method found. Please add a payment method to your account."
}
{
"error": "Payment failed. Please update your payment method."
}
{
"error": "Unable to parse phone number. Please provide a valid E.164 format number."
}
{
"error": "Failed to purchase phone number from provider. Please contact support."
}