Guía de Bland AI: API, precios y tutorial (2026)

Bland AI es una plataforma para crear agentes que hacen y reciben llamadas reales. Combina telefonía, reconocimiento y síntesis de voz, conversación, herramientas, transferencias, pruebas y analítica en un servicio administrado.

Para un prototipo basta enviar un número y una tarea en lenguaje natural a un endpoint. En producción puedes definir un Conversational Pathway, conectar APIs y conocimiento, transferir ciertas llamadas a personas y devolver el resultado por webhook.

Esta guía explica la API, la primera llamada, las funciones, el coste y la comparación con una pila modular.

Qué es Bland AI

Aporta la infraestructura de una conversación telefónica automática. El desarrollador define el objetivo, el grado de control y las conexiones con el negocio. Se usa para:

• Cualificar y seguir oportunidades comerciales.
• Reservar, confirmar y cambiar citas.
• Atender consultas habituales.
• Recoger información estructurada.
• Consultar pedidos, cuentas y disponibilidad durante la llamada.
• Derivar al equipo humano correcto.
• Encuestas, recordatorios y campañas salientes.

Además de hablar, consulta conocimiento, llama APIs, actualiza CRM, reserva y transfiere. Después devuelve transcripción, resumen, variables, resultado, duración y metadatos.

Referencia rápida

Tutorial: primera llamada

1. Cuenta y clave

Crea una cuenta y copia la clave del panel de desarrollo. Guárdala en una variable de servidor, nunca en código web o móvil. Los ejemplos usan BLAND_API_KEY.

2. Llamada con cURL

Send Call API requiere número E.164 y tarea. El valor de autorización es la clave sin prefijo.

curl --request POST \
  --url https://us.api.bland.ai/v1/calls \
  --header "Authorization: $BLAND_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "phone_number": "+15551234567",
    "task": "Call the customer to confirm tomorrow’s appointment. If the time no longer works, collect two preferred alternatives. Never invent availability."
  }'

Respuesta de éxito de ejemplo:

{
  "status": "success",
  "call_id": "9d404c1b-6a23-4426-953a-a52c392ff8f1"
}

La solicitud encola la llamada; no espera a que termine.

3. Llamada con TypeScript

Puedes usar fetch nativo de Node.js:

const response = await fetch("https://us.api.bland.ai/v1/calls", {
  method: "POST",
  headers: {
    Authorization: process.env.BLAND_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_number: "+15551234567",
    task: [
      "Confirm tomorrow's appointment.",
      "If the time does not work, collect two preferred alternatives.",
      "Do not claim a new time is booked until the scheduling tool confirms it.",
    ].join(" "),
  }),
});
 
if (!response.ok) {
  throw new Error(`Bland API request failed: ${response.status}`);
}
 
const call = (await response.json()) as {
  status: "success" | "error";
  call_id?: string;
  message?: string;
};
 
console.log(call.call_id);

Ejecuta solo en un servidor fiable. Una petición frontend expondría la clave a todos los visitantes.

4. Obtener el resultado

Usa el ID con Call Details o configura un webhook final para evitar sondeos.

curl --request GET \
  --url https://us.api.bland.ai/v1/calls/CALL_ID \
  --header "Authorization: $BLAND_API_KEY"

Los detalles pueden incluir estado, transcripción, resumen, duración, grabación y variables. Conserva solo los campos necesarios y define retención antes de recopilar llamadas reales.

Task, Pathway o Persona

Task para validar

Sirve para recordar, confirmar un dato o hacer pocas preguntas. Define un resultado observable, destinatario y motivo, información permitida, éxito, lo que no puede adivinar o cambiar, cuándo transferir o terminar y cómo tratar buzón y bajas. Si acumulas muchos if, pasa a Pathway.

Pathways para controlar

Conversational Pathways es un editor visual por nodos: generar diálogo, decir una frase, recoger variables, consultar conocimiento, llamar webhook, transferir o terminar. Las ramas etiquetadas limitan pasos válidos sin impedir comprender lenguaje natural.

Un agente de citas puede separar confirmación, nuevo horario, preguntas de clínica, persona desconocida, derivación a personal y registro de baja. Es más fácil revisar y probar que un único prompt largo.

Herramientas y conocimiento

Integraciones y herramientas HTTP permiten consultar disponibilidad y pedidos, actualizar CRM o llamar servicios internos. El conocimiento aporta referencias; los datos dinámicos añaden nombre, cita, estado o campaña por llamada.

Separa lectura y escritura: consultar una reserva y cancelarla requieren distinta autoridad. Valida entradas, haz las escrituras idempotentes y confirma acciones irreversibles.

Webhooks y operaciones

Eventos finales y en vivo

webhook recibe el resultado completo; webhook_events añade cola, llamada, latencia, herramientas y transferencias.

{
  "phone_number": "+15551234567",
  "pathway_id": "YOUR_PATHWAY_ID",
  "request_data": {
    "customer_name": "Jordan",
    "appointment_date": "September 20, 2026"
  },
  "metadata": {
    "customer_id": "cus_123",
    "campaign": "appointment-confirmation"
  },
  "webhook": "https://example.com/webhooks/bland"
}

La guía explica configuración general y por llamada. En producción verifica firmas, responde pronto, procesa lo pesado de forma asíncrona y admite reintentos y duplicados.

Transferencia humana

Puedes transferir a un número, asignar intenciones a equipos o usar nodos. Trátalo como estado normal: motivo, hechos recogidos y alternativa si no hay personal. Una transferencia sin contexto obliga a empezar de nuevo y oculta fallos en las métricas.

Entrada y telefonía

Compra o activa un número y asigna un agente en el panel. Cada número puede tener configuración y webhooks propios. Puedes conectar Twilio y, en Enterprise, SIP. Verifica disponibilidad, tarifas, regiones, transferencias y obligaciones regulatorias en cada mercado.

Lotes

Batch Calls inicia campañas desde CSV o API, con variables individuales para nombre, cita y cuenta. Empieza con pocos destinatarios y mide respuesta, finalización, bajas, transferencias y coste antes de aumentar concurrencia. El volumen amplifica la calidad y el cumplimiento existentes.

Pruebas y seguimiento

Una demo con guion no basta: las personas interrumpen, callan, dan datos incompletos, deletrean, llegan al buzón, cambian de tema y piden hablar con alguien.

• Testbed: iterar nodos con datos reales.
• Scenarios: simular interlocutores y situaciones.
• Standards: convertir interacciones conocidas en regresiones repetibles.
• Evals: puntuar llamadas con criterios configurables.
• Guard Rails: vigilar respuestas y activar acciones ante incumplimientos.
• Alerts: avisar al superar umbrales o condiciones propias.

Repite escenarios importantes: el modelo es probabilístico. Incluye silencio, interrupciones, ruido, acentos, números, nombres, fallos de herramientas, personal ausente y rechazo explícito. Guard Rails complementa, pero no sustituye permisos limitados, consentimiento, seguimiento representativo y revisión jurídica.

CLI y MCP

La CLI gestiona llamadas, Pathways, números, registros, reenvío local de webhooks, validación, pruebas y promoción. Facilita revisar y repetir cambios.

El servidor MCP conecta Codex, Cursor, Claude Code, VS Code y otros clientes para gestionar recursos mediante herramientas estructuradas. Es la interfaz del desarrollador y operador, no el modelo de voz que habla por teléfono.

Precios de 2026

Tarifas públicas comprobadas el 19 de septiembre de 2026:

Start incluye dos créditos iniciales y un número entrante, no llamadas ilimitadas gratis. Se factura por segundo conectado. La tarifa incluye LLM, reconocimiento y síntesis; operador y números se pagan aparte.

monthly cost ≈ platform fee
             + connected minutes × talk-time rate
             + transfer minutes × transfer rate
             + carrier, phone-number, and optional feature charges

La diferencia por minuto compensa por sí sola los $299 de Build alrededor de 14,950 minutos mensuales. Puede ser necesario antes por límites diarios o simultáneos. Estima con respuesta, duración, transferencias e intentos fallidos reales.

Admite operador integrado a coste repercutido, Twilio propio y SIP empresarial. Con telefonía propia no se paga la transferencia de Bland, pero sí operador y uso de IA. Enterprise añade infraestructura dedicada, local o VPC, SSO, residencia, BAA, límites y apoyo técnico. Consulta los precios oficiales.

Agent Phone Plan por separado

Por $29.99 al mes ofrece a un agente autónomo un número de EE. UU. para voz y SMS en EE. UU. y Canadá, con uso razonable y una llamada activa. Sirve para un asistente con línea propia, no para un centro de contacto de alto volumen.

Frente a Vapi, Retell y una pila propia

Bland favorece velocidad de producción, factura IA previsible y operación unificada. Una pila modular favorece portabilidad y control fino de componentes.

Ventajas y límites

Ventajas

• Una API para entrada y salida, con prototipos rápidos.
• Pathways más controlables que un prompt largo.
• Herramientas, conocimiento, transferencias, lotes y webhooks integrados.
• Pruebas, evaluaciones, Guard Rails y alertas para operación.
• CLI y MCP para equipos orientados a código.
• Twilio, SIP y opciones empresariales.
• LLM, reconocimiento y síntesis agrupados por tiempo de conversación.

Límites

• Pathways y prompts específicos aumentan el trabajo de migración.
• Menos libertad para cambiar cada proveedor.
• El precio visible no incluye todo operador, número, transferencia u opción.
• Parte del gobierno y enrutamiento avanzado es empresarial.
• Calidad y latencia requieren pruebas con tus usuarios, idiomas, herramientas y rutas.

Cuándo elegirlo

Encaja cuando las llamadas son esenciales y necesitas entrada, salida, datos en vivo, acciones, ramas y personas en una plataforma. Es práctico si operaciones quiere editor visual y desarrollo necesita API y CLI.

Puede ser excesivo para una notificación poco frecuente, o inadecuado si exiges control completo del modelo, voz o runtime abierto.

Lista de producción

1. Resultado medible: confirmar, cualificar, reservar, recoger, derivar o resolver algo observable.
2. Autoridad limitada: solo datos y acciones necesarios.
3. Derivación: contexto, fuera de horario y medición de fallos.
4. Consentimiento y bajas: revisar con profesionales divulgación, grabación, horarios y exclusión de llamadas por jurisdicción.
5. Seguridad: secretos en servidor, firmas, autenticación e idempotencia.
6. Casos difíciles: silencio, interrupciones, acentos, buzón, ruido, fallos y peticiones imprevistas.
7. Embudo completo: respuesta, éxito, escalado, bajas, latencia, reintentos y coste por resultado.
8. Despliegue gradual: pruebas internas, grupo representativo y ampliación respaldada por datos.

Preguntas frecuentes

¿Tiene API?

Sí: REST para llamadas, Pathways, números, herramientas, conocimiento, lotes, pruebas y registros. La salida básica es POST /v1/calls.

¿Dónde obtengo la clave?

En el panel de desarrollo tras registrarte. Envíala directamente en Authorization, sin Bearer, y guárdala como secreto del servidor.

¿Puede recibir llamadas?

Sí. Activa o importa el número y configura agente, Pathway, prompt y webhook. La misma plataforma permite salida mediante API, panel o lotes.

¿Cuánto cuesta?

Start: sin cuota y $0.14/minuto conectado. Build: $299/mes y $0.12/minuto. Transferencias, operador, números y opciones suman coste. Enterprise se negocia.

¿Es gratis?

Empezar sí, con créditos; el uso continuo conectado se factura.

¿Admite HIPAA?

Bland indica elegibilidad Enterprise con BAA firmado. Eso no garantiza cumplimiento de la aplicación: revisa datos, acceso, retención, grabación y controles con especialistas jurídicos y de seguridad.

¿Funciona con Codex?

Sí, hay configuración MCP para Codex, Cursor, Claude Code, VS Code y otros. El agente de programación gestiona recursos y el de voz atiende la conversación.

Conclusión

Bland convierte una pila de voz compleja en una interfaz directa: definir conversación, conectar acciones, asignar número y llamar a la API. Task valida ideas; Pathways, herramientas, webhooks, pruebas y transferencias aportan control real.

Obtienes velocidad, integración y facturación IA más sencilla a cambio de aceptar sus flujos, precios y papel en la ruta crítica. Si encaja, permite producir agentes telefónicos sin mantener toda la infraestructura.