Helpium

Agrega el chat de soporte nativo de Helpium a tu aplicación Android. 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 compatible con Android 5.0 (API 21) y versiones posteriores y funciona igual desde **Java** y **Kotlin**. Utiliza vistas de Android simples sin androidx, AppCompat o Compose, por lo que se adapta tanto a proyectos antiguos como nuevos. Su única dependencia es OkHttp.

## 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. Agrega la dependencia

Agrega JitPack a tus repositorios en `settings.gradle` (o en el `build.gradle` raíz en proyectos más antiguos):

```gradle
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
    }
}

Luego agrega el SDK a app/build.gradle:

dependencies {
    implementation "com.github.helpium-io:helpium-sdk:0.1.0"
}

El SDK declara sus propios permisos, pantalla de chat y reglas de compresión, por lo que no hay nada más que configurar.

2. Configura el SDK al iniciar

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        Helpium.configure(this, "YOUR_WIDGET_KEY");
    }
}

Registra la clase con android:name=".MyApplication" en la etiqueta <application> de tu manifiesto.

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 luego los sigue a cualquier dispositivo, y las acciones de IA pueden funcionar en su cuenta. Consulta Verifica la identidad de tus clientes.

Helpium.identify(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 correo electrónico antes del primer mensaje cuando la configuración de tu Chat en vivo lo requiere.

4. Abre el chat

helpButton.setOnClickListener(view -> Helpium.present(this));

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

5. Muestra respuestas no leídas

Helpium.addUnreadCountListener(count -> {
    badge.setVisibility(count > 0 ? View.VISIBLE : View.GONE);
    badge.setText(String.valueOf(count));
});

Elimina el listener con Helpium.removeUnreadCountListener cuando tu pantalla desaparezca.

Colores y textos

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

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

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

Cada texto puede ser reemplazado por idioma con recursos de cadena. Android elige la carpeta correcta para cada idioma:

<!-- res/values/strings.xml -->
<string name="helpium_greeting">¡Hola! ¿Te ayudamos con tu pedido?</string>
<!-- res/values-es/strings.xml -->
<string name="helpium_greeting">¡Hola! ¿Te ayudamos con tu pedido?</string>

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 aplicación de Android