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."
}

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.

Este endpoint te permite comprar un número de teléfono que se haya encontrado mediante el endpoint de búsqueda. La plataforma gestiona automáticamente el precio, la facturación y el aprovisionamiento.

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

Mostrar Propiedades de los datos

integer

El identificador único del número de teléfono

string

El número de teléfono en formato E.164

string

El código de país ISO

string

El tipo de número de teléfono (siempre normal para los números comprados)

boolean

Indica si el número admite SMS

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."
}

Referencia de la API

Asistentes de IA

Carpetas

Etiquetas

Leads

Campañas

Automatizaciones

Acciones durante la llamada

Chatbot de IA

Respuestas de IA

Bases de conocimiento

SMS

WhatsApp

Números de teléfono

Trunks SIP

Llamadas

Webhooks

Comprar número de teléfono

Cuerpo de la solicitud

Campos de respuesta

Cómo funciona

​Cuerpo de la solicitud

​Campos de respuesta

​Cómo funciona

Cuerpo de la solicitud

Campos de respuesta

Cómo funciona