Discussions

Necesitamos confirmar algunos aspectos técnicos de la API REST para poder implementar una vinculación completa.
Agradezco si pueden brindarnos detalles sobre lo siguiente:

🔐 Autenticación

¿Cuál es el método de autenticación de la API (API key, Bearer token, Basic Auth)?

¿Dónde se obtiene la API key y qué vigencia tiene?

¿Existe entorno sandbox o de pruebas para desarrollo?

🔗 Endpoints y operaciones

¿Cuál es el endpoint correcto para crear nuevos leads/contactos desde un sistema externo (por ejemplo, /webcontact/)?

¿Qué operaciones están disponibles: crear, leer, actualizar o eliminar leads?

¿La API permite asignar un lead a un proyecto, desarrollo o asesor específico (por ID)?

¿Existe un endpoint para actualizar el estado del lead (por ejemplo: contactado, visita, vendido)?

🧾 Estructura y campos

¿Podrían compartir un ejemplo de payload JSON válido para la creación de un lead?

¿Cuáles son los campos obligatorios y opcionales?

¿Se pueden incluir campos personalizados como source u origin (por ejemplo "Chatbot QR", "WhatsApp", etc.)?

¿Cómo maneja la API los duplicados (por teléfono o email)?

¿Qué formato esperan para los números de teléfono (+54911xxxxxxx, 011xxxxxxx, etc.)?

⚙️ Límites y errores

¿Qué rate limit maneja la API (requests por minuto/hora)?

¿Qué estructura usan para los mensajes de error o validaciones (códigos HTTP y respuesta JSON)?

¿La API devuelve un ID o referencia del lead creado exitosamente?

🔄 Webhooks o callbacks

¿Tokko ofrece webhooks o notificaciones automáticas para cuando un lead cambia de estado dentro del CRM?

¿Se puede consultar el estado de un lead específico vía API (GET /lead/{id})?

🔒 Seguridad

¿Se requiere conexión HTTPS obligatoria?

¿Hay alguna política recomendada de retry o backoff para evitar bloqueos por rate limit?

Muchas gracias 🙌
Queremos implementar una integración segura y completa, así que cualquier ejemplo o documentación adicional será de gran ayuda.
Saludos,