Flujos de WhatsApp lanzados desde tu sistema
Diseña el flujo en el editor visual y arráncalo en el chat del cliente con una petición, como si él lo hubiera iniciado.
/flow-launchcurl -X POST https://api.kontacto.pro/flow-launch \
-H "Content-Type: application/json" \
-d '{
"api_key": "TU_API_KEY",
"sender": "51999888777",
"number": "51987654321",
"flow": "0199a3b2-7c4e-7d21-9f3a-5b8e2c1d4f60"
}'
<?php
$datos = [
'api_key' => 'TU_API_KEY',
'sender' => '51999888777',
'number' => '51987654321',
'flow' => '0199a3b2-7c4e-7d21-9f3a-5b8e2c1d4f60',
];
$ch = curl_init('https://api.kontacto.pro/flow-launch');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($datos),
CURLOPT_RETURNTRANSFER => true,
]);
$respuesta = json_decode(curl_exec($ch), true);
const datos = {
api_key: 'TU_API_KEY',
sender: '51999888777',
number: '51987654321',
flow: '0199a3b2-7c4e-7d21-9f3a-5b8e2c1d4f60',
};
const respuesta = await fetch('https://api.kontacto.pro/flow-launch', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(datos),
});
console.log(await respuesta.json());
import requests
datos = {
"api_key": "TU_API_KEY",
"sender": "51999888777",
"number": "51987654321",
"flow": "0199a3b2-7c4e-7d21-9f3a-5b8e2c1d4f60",
}
respuesta = requests.post("https://api.kontacto.pro/flow-launch", json=datos, timeout=30)
print(respuesta.json())
Lo que necesitas saber
-
Editor visual
Mensajes, opciones, preguntas que guardan variables, ubicación y derivación a un agente.
-
Formularios
Envía form en vez de flow y el cliente responde pregunta por pregunta.
-
Agenda
Un paso del flujo ofrece horarios libres y reserva la cita.
Respuesta de la API
Todas las respuestas son JSON con status y un mensaje. Si algo falla, el detalle viene en errors.
{
"status": true,
"msg": "Flujo iniciado"
}
Todos los parámetros y los errores posibles están en la documentación de flujos por api.
¿Dónde encuentro el UUID del flujo?
En la URL del editor del flujo o del formulario.
¿Qué permiso necesita la API key?
flows:launch, si usas una clave adicional. La clave principal ya lo tiene.
¿En qué plan está?
En API Pro.
Funciones relacionadas
-
Respuestas automáticas de WhatsApp por palabra clave
Tu cliente escribe "precios" y recibe la respuesta al instante. Lo que no coincide con ninguna palabra sigue a tu webhook. API Pro -
Chatbot de WhatsApp con inteligencia artificial
Pega tu clave de Anthropic, OpenAI o Google, escribe las instrucciones de tu negocio y la IA contesta los chats de ese número. API Pro -
Varias API keys con permisos para tu WhatsApp
Una clave por sistema: tu web, tu ERP y tu facturador, cada uno con lo justo. Si una clave se filtra, la borras y las demás siguen funcionando.
Envía tu primer mensaje hoy
Escríbenos por WhatsApp, conectamos tu número con un QR y te damos tu API key para que pruebes desde tu sistema.