Helpium

Agrega el chat de soporte nativo de Helpium a tu aplicación iOS. Tus clientes hablan con tu IA y tu equipo sin salir de la aplicación, y sus conversaciones llegan a la misma bandeja de entrada que tu chat web, correo electrónico y WhatsApp.

El SDK es un paquete Swift con una interfaz nativa SwiftUI. Necesita iOS 15 o posterior y no tiene otras dependencias. Funciona en aplicaciones SwiftUI y UIKit.

## Antes de comenzar

En Helpium, abre **Canales → Chat en vivo** y copia tu **clave de widget**. Identifica tu espacio de trabajo y es seguro incluirla en la aplicación.

## 1. Instala el paquete

En Xcode, elige **Archivo → Agregar dependencias de paquete…**, pega la URL del repositorio y agrega el producto **Helpium** a tu objetivo de aplicación:

https://github.com/helpium-io/helpium-sdk


Los clientes pueden adjuntar fotos desde la cámara, así que agrega una descripción de uso de cámara a tu `Info.plist`:

```xml
<key>NSCameraUsageDescription</key>
<string>Toma una foto para enviar a nuestro equipo de soporte.</string>

2. Configura el SDK al iniciar

import Helpium

@main
struct MyApp: App {
    init() {
        Helpium.configure(widgetKey: "YOUR_WIDGET_KEY")
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

En una aplicación UIKit, llama a Helpium.configure en application(_:didFinishLaunchingWithOptions:).

3. Dile a Helpium quién es el cliente

Cuando un cliente inicia sesión en tu aplicación, pasa un token que tu servidor firma con el secreto de identidad del espacio de trabajo. Su conversación los seguirá a cualquier dispositivo, y las acciones de IA pueden funcionar en su cuenta. Consulta Verifica la identidad de tus clientes.

Helpium.identify(userJwt: tokenFromYourServer)

// Al cerrar sesión
Helpium.logout()

¿No hay inicio de sesión en tu aplicación? Salta este paso. El chat pide un nombre y un correo electrónico antes del primer mensaje cuando la configuración de tu Chat en vivo lo requiere.

4. Abre el chat

// Desde cualquier botón
Helpium.present()

// O como una vista SwiftUI que empujas o incrustas
NavigationLink("Ayuda") { Helpium.chatView() }

El chat se abre directamente en la conversación abierta del cliente. Sin una, muestra tu saludo y respuestas instantáneas, listo para escribir.

5. Muestra respuestas no leídas

let listener = Helpium.addUnreadCountListener { count in
    helpBadge.isHidden = count == 0
    helpBadge.text = "\(count)"
}

Mantén el listener devuelto; se detiene cuando se libera.

Colores y textos

Cada color es configurable, por separado para modo claro y oscuro:

Helpium.setAppearance(HelpiumAppearance(
    light: HelpiumColors(primary: "#0ea5e9", headerBackground: "#0ea5e9", headerText: "#ffffff"),
    dark: HelpiumColors(primary: "#38bdf8", background: "#0f172a", surface: "#1e293b")
))

Cualquier color que dejes fuera utiliza tu color de marca de la configuración de Chat en vivo o un predeterminado neutral.

Cada texto puede ser reemplazado por idioma. Agrega claves como helpium_greeting o helpium_welcome_title a los Localizable.strings de tu aplicación, o establece uno desde el código:

Helpium.setString("¡Hola! ¿Necesitas ayuda con tu pedido?", for: "greeting")

Próximos pasos

Envía notificaciones push para respuestas de agentes
Verifica la identidad de tus clientes
La referencia completa del SDK en GitHub enumera cada método, color y clave de texto.

Agrega chat en vivo a tu app de iOS