Anotar en una oportunidad
https://api.afer.pro/api/v1/crm/opportunities/{id}/notes
POST https://api.afer.pro/api/v1/crm/opportunities/{id}/notes
Apunta lo que ha pasado en una oportunidad y, si se sabe, deja planificado el siguiente paso.
Es «Registrar acción» de la ficha del CRM, hecho desde fuera: una anotación en el timeline de la oportunidad (una llamada, un WhatsApp, una reunión, una nota) y, opcionalmente, una tarea en el calendario con la fecha del siguiente paso. Cuando se planifica un siguiente paso, la oportunidad actualiza su «próxima acción» igual que lo hace la pantalla.
A diferencia de la ficha, el siguiente paso no es obligatorio: si no se envía siguiente, la nota se guarda sin él. Está pensado para que un asistente pueda apuntar lo que le dicen sin convertir cada nota en un interrogatorio.
La oportunidad se identifica con el oportunidadId que devuelve buscarOportunidad (o consultarOportunidades); también se acepta el numérico legacy.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación con API key: sin credenciales responde 401.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
oportunidadIdstring|intobligatorio | La oportunidad (en la ruta, {id}): id cifrado o numérico legacy. Debe pertenecer a tu cuenta. |
notastringobligatorio | Qué ha pasado. Obligatoria salvo que se envíe siguiente. |
mediostringopcional | Por dónde ha sido: llamada, whatsapp, email, reunion, visita, sms o nota (por defecto). Decide el tipo de anotación del timeline. |
fechadateopcional | Cuándo pasó (YYYY-MM-DD). Por defecto, ahora. Una fecha futura se sustituye por ahora. |
horastringopcional | A qué hora pasó (HH:MM). |
siguienteobjectopcional | El siguiente paso: fecha (YYYY-MM-DD, obligatoria), hora (HH:MM), medio (llamada, whatsapp, email, reunion, visita, sms, tarea) y descripcion. Sin descripción se pone el medio y el título de la oportunidad. |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/crm/opportunities/aBc123XyZ/notes' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"nota": "WhatsApp de Aina: se disculpa por no contestar ayer. La propuesta va por buen camino.",
"medio": "whatsapp",
"siguiente": {
"fecha": "2026-10-22",
"medio": "llamada"
}
}'
<?php
$data = [
'nota' => 'WhatsApp de Aina: se disculpa por no contestar ayer. La propuesta va por buen camino.',
'medio' => 'whatsapp',
'siguiente' => [
'fecha' => '2026-10-22',
'medio' => 'llamada',
],
];
$ch = curl_init('https://api.afer.pro/api/v1/crm/opportunities/aBc123XyZ/notes');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
'Content-Type: application/json',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/crm/opportunities/aBc123XyZ/notes', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"nota": "WhatsApp de Aina: se disculpa por no contestar ayer. La propuesta va por buen camino.",
"medio": "whatsapp",
"siguiente": {
"fecha": "2026-10-22",
"medio": "llamada"
}
})
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"oportunidadId": "aBc123XyZ…",
"nombre": "MIXING MEDIA SL",
"titulo": "Consultoría IA",
"notaId": "dEf456…",
"fecha": "2026-10-16 20:21:00",
"medio": "whatsapp",
"siguiente": {
"tareaId": "gHi789…",
"fecha": "2026-10-22",
"hora": "",
"medio": "llamada",
"descripcion": "Llamar · Consultoría IA"
},
"proxima_accion": {
"texto": "Llamar · Consultoría IA",
"fecha": "2026-10-22 00:00",
"medio": "llamada"
},
"anotaciones": 4
}
}
Errores
| Caso | Resultado |
|---|---|
| Sin credenciales de API key | errorCode 401. |
oportunidadId ausente o inválido; ni nota ni siguiente; siguiente.fecha sin formato YYYY-MM-DD |
errorCode 400. |
| La oportunidad no existe o no es de tu cuenta | errorCode 404. |
- La anotación queda a nombre de la persona dueña de la API key, como en la ficha.
- La tarea del siguiente paso se asigna a quien lleva la oportunidad; si no tiene nadie asignado, a la persona de la API key.
- Acepta la cabecera
X-IDEMPOTENCY-KEYcontra dobles envíos: sin ella, cada llamada crea una anotación nueva.