Incluido en API Básico y API Pro
Encuestas de WhatsApp enviadas por API
Una pregunta y de 2 a 5 opciones. Tu cliente responde con un toque, sin escribir.
POST
/send-pollcurl -X POST https://api.kontacto.pro/send-poll \
-H "Content-Type: application/json" \
-d '{
"api_key": "TU_API_KEY",
"sender": "51999888777",
"number": "51987654321",
"name": "¿Qué tal fue tu atención de hoy?",
"option": ["Excelente", "Buena", "Mejorable"],
"countable": "1"
}'
<?php
$datos = [
'api_key' => 'TU_API_KEY',
'sender' => '51999888777',
'number' => '51987654321',
'name' => '¿Qué tal fue tu atención de hoy?',
'option' => ['Excelente', 'Buena', 'Mejorable'],
'countable' => '1',
];
$ch = curl_init('https://api.kontacto.pro/send-poll');
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',
name: '¿Qué tal fue tu atención de hoy?',
option: ['Excelente', 'Buena', 'Mejorable'],
countable: '1',
};
const respuesta = await fetch('https://api.kontacto.pro/send-poll', {
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",
"name": "¿Qué tal fue tu atención de hoy?",
"option": ["Excelente", "Buena", "Mejorable"],
"countable": "1",
}
respuesta = requests.post("https://api.kontacto.pro/send-poll", json=datos, timeout=30)
print(respuesta.json())
Lo que necesitas saber
-
De 2 a 5 opciones
Sin repetir. Por GET van separadas por coma.
-
Una o varias
countable = "1" permite una sola respuesta por persona.
-
También en canales
Publica la encuesta en tu canal de WhatsApp con el mismo endpoint.
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": "Mensaje enviado con éxito!"
}
Todos los parámetros y los errores posibles están en la documentación de encuestas.
¿Para qué sirve una encuesta por WhatsApp?
Para medir la satisfacción después de una venta, confirmar asistencia o elegir un horario sin que el cliente tenga que escribir.
¿Puedo enviarla a un grupo?
Sí. Usa el id del grupo (…@g.us) como number. El endpoint /groups te da la lista.
Funciones relacionadas
-
Enviar mensajes de WhatsApp por API
Una petición HTTP con tu API key, tu número y el destino. El mensaje sale desde tu WhatsApp y la respuesta llega en JSON. -
API de grupos de WhatsApp
Obtén los grupos donde participa tu número con su id, cantidad de miembros y si puedes escribir. Luego usa ese id como destino. -
API de canales de WhatsApp para publicar automáticamente
Registra el canal una vez con su enlace de invitación y publica en él con los mismos endpoints de mensajes.
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.