// Habilitada:
// - Cada formulario enviado se envía a Tokko CRM
// - Se registra el envío en logs

// Deshabilitada:
// - Formularios funcionan solo en Houzez
// - No se envían a Tokko Broker

Usuario en WordPress
         ↓
    Completa formulario
         ↓
    Houzez form submission
         ↓
    Hook: houzez_after_agent_form_submission
         ↓
    Tokko_Contact_Integration
         ↓
    API Tokko: submitContact()
         ↓
    Tokko Broker CRM
         ↓
    Lead registrado

add_action('houzez_after_agent_form_submission',
  'thi_handle_contact_submission', 10, 3);

// Parámetros:
// $form_data - Datos del formulario
// $property_id - ID de la propiedad
// $agent_id - ID del agente (si aplica)

array(
  'name' => 'Juan García',           // Nombre completo
  'email' => 'juan@email.com',       // Email
  'phone' => '+54 9 11 2345-6789',   // Teléfono
  'message' => 'Consulta sobre...',  // Mensaje
  'property_id' => '12345',          // ID Tokko
  'property_title' => 'Depto 3am',   // Título
  'property_price' => '250000',      // Precio
  'property_type' => 'Departamento',  // Tipo
  'property_location' => 'Buenos...',// Ubicación
  'agent_id' => '789',               // Agent ID
  'source' => 'website'              // Origen (siempre 'website')
)

// Se envían si están disponibles:
'additional_phone' => '...',     // Teléfono alternativo
'company' => '...',              // Empresa del cliente
'address' => '...',              // Dirección del cliente
'notes' => '...',                // Notas adicionales

class Tokko_Contact_Integration {

  /**
   * Maneja el envío de formulario de Houzez
   */
  public static function handle_submission($form_data, $property_id, $agent_id) {
    // Valida datos
    // Prepara payload
    // Envía a Tokko API
    // Registra resultado
  }

  /**
   * Envía el contacto a Tokko CRM
   */
  private static function send_to_tokko($contact_data) {
    // Llama TokkoAPI::submitContact()
    // Maneja errores
    // Registra en logs
  }
}

/**
 * Envía un nuevo contacto al CRM de Tokko
 *
 * @param array $contact_data Datos del contacto
 * @return array Respuesta de API
 */
public static function submitContact($contact_data) {
  $endpoint = '/crm/contact/create';

  return self::make_request('POST', $endpoint, $contact_data);
}

// El plugin:
1. Registra el error en logs
2. Muestra mensaje al usuario
3. Guarda el lead localmente (pendiente)
4. Reintentos automáticos cada 5 minutos

# Logs de WordPress
tail -f /var/www/html/wp-content/debug.log | grep "contact_integration"

# O accede a:
# WordPress > Tokko Plugins > Dashboard > Historial de Errores

✓ Email tiene formato válido
✓ Nombre no está vacío
✓ Teléfono tiene formato válido (si se envía)
✓ Property ID existe en WordPress
✓ Mensaje no está vacío
✓ No es spam detectado

// Escapa caracteres especiales
sanitize_text_field($name)
sanitize_email($email)
wp_kses_post($message)

☑ Mostrar formulario de contacto
☑ Usar email de agente
☑ Guardar en Houzez (WordPress)
  + Enviar a Tokko (habilitado en Plugins)

// En el formulario de WordPress, puedes:
1. Cambiar el field agent_id antes de enviar
2. En Tokko CRM, reasignar después de recibir

// Ejemplo: Envía a Slack también
add_action('thi_contact_submitted', function($contact_data) {
  send_to_slack_webhook($contact_data);
});

Dashboard > Leads > Exportar a CSV

<input type="checkbox" required>
Autorizo el tratamiento de mis datos personales

Proceso:
1. Solicitud a tu sitio WordPress
2. Elimina datos en WordPress
3. Solicita eliminación en Tokko Broker manualmente

// Verifica:
1. La API key está completa (sin espacios)
2. Tiene permisos para "CRM" en Tokko
3. No ha expirado en el panel de Tokko
4. El usuario API tiene acceso a contactos

// Posibles causas:
1. Email inválido
2. Teléfono con formato incorrecto
3. Mensaje vacío
4. Conexión a internet lenta/caída

// Solución:
Revisa el log de errores en Debug Log

// Posibles causas:
1. Usuario hizo clic varias veces en enviar
2. Página se recargó durante envío
3. Reintentos automáticos se activaron

// Solución:
Implementa validación de cliente-side en JavaScript
para deshabilitar botón después de primer clic

// Después de enviar, muestra:
"Gracias por tu consulta.
 Nos contactaremos en breve."

// NO:
"Datos enviados al servidor"  // Demasiado técnico