Completar la carga de una foto
Comprueba que los bytes cargados sean un JPEG o un PNG de hasta 5 MB, del tipo con que se enviaron, y los convierte en la foto de la ubicación. No envíes cuerpo. Completar una carga que ya terminó no cambia nada; sin una carga en curso y sin foto, 409 conflict.
Permiso: knowledge:write.
bearerAuthAuthorizationBearer <clave>Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.
location_id*stringID de la ubicación.
uuidIdempotency-Key?stringOpcional. Un valor que eliges, único por escritura lógica, de 8 a 200 caracteres: un UUID o un ID de tu sistema, como order-10482-ready. Reintentar con la misma clave y el mismo cuerpo repite la primera respuesta en lugar de repetir la escritura.
8 <= length <= 200Éxito.
application/json- response
data*Una sucursal o un lugar que los agentes pueden enviar como ubicación de WhatsApp.
curl -X POST 'https://getricky.ai/api/v1/knowledge/locations/497f6eca-6276-4993-bfeb-53cbbbba6f08/photo/complete' \ -H 'Idempotency-Key: order-10482-ready'{ "data": { "id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f", "name": "Casa Nativa Albrook", "address": "Albrook Mall, local 214, Panamá", "latitude": 8.9733, "longitude": -79.5511, "street": "Albrook Mall, local 214", "city": "Panamá", "state": "Panamá", "postal_code": null, "country": "Panamá", "country_code": "PA", "phone": "+50760000000", "email": "albrook@example.com", "hours": "Lunes a sábado, 10:00 a 20:00", "photo": { "mime_type": "image/jpeg", "size_bytes": 482133, "download_url": null } }}Quitar la foto de una ubicación DELETE
Quita la foto y cualquier carga en curso, y responde la ubicación. Las copias ya enviadas en conversaciones se quedan ahí. Una ubicación sin foto se queda igual. Permiso: `knowledge:write`.
Listar contactos del directorio GET
Las tarjetas de contacto del directorio de conocimiento, por nombre visible. No son contactos del CRM. Permiso: `knowledge:read`.