# Integración con Solitics

<Aside type="caution" icon="setting" title="Se necesita la ayuda de un desarrollador">
 Necesitará la ayuda de su equipo de desarrollo para configurar la integración. Por favor, comparta esta guía con ellos.
</Aside>

[Solitics](https://solitics.com/) es una plataforma avanzada de gestión de datos y automatización de marketing en tiempo real que permite a las marcas B2C ofrecer experiencias altamente personalizadas a sus clientes. Al aprovechar los datos de los clientes, las empresas pueden aumentar los ingresos a través de la mejora de las tasas de conversión y retención, todo ello mientras reducen significativamente los gastos de desarrollo y TI.

Cuando se combina con Pushwoosh, las capacidades de gestión de datos de Solitics permiten a las marcas entregar mensajes altamente dirigidos y relevantes a sus usuarios. Esto asegura que los usuarios reciban contenido y ofertas que se adaptan específicamente a sus intereses y necesidades, mejorando así su experiencia general.

Las marcas también pueden usar Solitics para analizar los datos de los usuarios e identificar áreas de mejora en el recorrido del usuario. Al integrar estos datos con Pushwoosh, las marcas pueden enviar notificaciones push para volver a atraer a los usuarios que puedan haber abandonado su recorrido, dirigiéndolos de nuevo a la aplicación o al sitio web y, en última instancia, mejorando las tasas de conversión.

## Casos de uso

A continuación se presentan algunos casos de uso prácticos que demuestran cómo la integración de Solitics y Pushwoosh se puede utilizar para mejorar la experiencia del cliente e impulsar los resultados empresariales:

### Promociones y ofertas personalizadas

Las empresas pueden utilizar los datos de Solitics para analizar las preferencias y comportamientos de los clientes. Luego, pueden enviar notificaciones push personalizadas a través de Pushwoosh con promociones y ofertas adaptadas a los intereses de cada individuo.

### Aumento de la participación

Las empresas de juegos pueden configurar Solitics para monitorear las acciones y logros de los jugadores, y luego utilizar Pushwoosh para entregar rápidamente notificaciones push sobre hitos y eventos especiales a los jugadores, fomentando la participación activa en actividades específicas del juego.

### Alertas de seguridad

Las aplicaciones bancarias pueden mantener la confianza de sus clientes en la seguridad de sus datos gracias a la integración de Solitics + Pushwoosh. Pueden configurar Solitics para monitorear la actividad de la cuenta y activar alertas por comportamiento inusual. Luego, pueden usar Pushwoosh para entregar notificaciones push en tiempo real para notificar a los clientes afectados, fomentando una acción rápida para proteger sus cuentas y prevenir posibles problemas.

## Configuración de la integración

El proceso de integración implica dos pasos principales:

1. Incorporar el SDK de Pushwoosh en su sitio web o aplicación móvil.
2. Establecer un ID de usuario que sirva como identificador único tanto para Solitics como para Pushwoosh.

### Prerrequisitos

1. Cuenta de Pushwoosh
2. [Token de acceso a la API de Pushwoosh](/es/developer/api-reference/api-access-token): Para permitir la transmisión de datos a Pushwoosh, necesita generar un token de acceso a la API de Pushwoosh. Para obtenerlo, vaya a **Ajustes > Acceso a la API** y cópielo allí.
3. Código de la aplicación de Pushwoosh: Del mismo modo, necesitará localizar su Código de la aplicación de Pushwoosh para facilitar la transferencia de datos a Pushwoosh. Para ello, busque el nombre del proyecto en la esquina superior izquierda y copie el código que se muestra debajo.
4. [Cuenta de Solitics](https://dashboard.solitics.com/#/pages/signin)

<Aside type="note">
Para habilitar la integración, registre a cada usuario tanto en Solitics como en Pushwoosh utilizando el mismo ID de miembro. Este es el requisito principal para que la integración funcione eficazmente.
</Aside>

### Configuración de Pushwoosh para la integración

1. Configure una cuenta de Pushwoosh si no tiene una.
2. Configure sus proyectos. [Aprenda más sobre cómo hacerlo.](/es/product/first-steps/start-with-your-project/configure-platforms)
3. A continuación, cree una aplicación dentro de Pushwoosh y seleccione los canales de comunicación preferidos. Puede optar por utilizar una aplicación existente si ya tiene una.

### Configuración de Solitics para la integración

1. Póngase en contacto con Solitics ([support@solitics.com](mailto:support@solitics.com)) y solicite integrar su marca con Pushwoosh.

Especifique los siguientes detalles:

* Clave de la API de Pushwoosh
* Código de la aplicación de Pushwoosh

2. El equipo de Solitics le proporcionará un token de acceso para futuras interacciones con la API de Solitics.

## Registro de usuarios

Como se ha subrayado anteriormente, es importante registrar a los usuarios con ID de usuario idénticos tanto en Solitics como en Pushwoosh.

<Aside type="note">
Utilice el mismo ID de miembro único que su marca utiliza para la integración de miembros al registrarse para las notificaciones push. Esta consistencia no solo garantizará que su ID de miembro sea único, sino que también agilizará el seguimiento y facilitará la depuración en caso de cualquier problema.
</Aside>

### Registro con Pushwoosh

Pushwoosh ofrece dos métodos para asociar un ID de usuario con un dispositivo específico. Si no utiliza estos métodos, Pushwoosh empleará automáticamente el ID de hardware del dispositivo como identificador del usuario.

Para vincular un ID de usuario a un dispositivo en Pushwoosh, puede elegir uno de los siguientes métodos:

#### `setUserId`

Esta es una función del SDK que le permite establecer un valor de cadena como un ID de Pushwoosh, que se asociará automáticamente con un ID de hardware (HWID) utilizado por Pushwoosh para identificar dispositivos.

**Android**

<LinkCard title="setUserId – Android" href="https://github.com/Pushwoosh/pushwoosh-android-sdk/blob/master/Documentation/inapp/PushwooshInApp.md#1a69cdb1592ad7640a49ba8bac8a14d54d" />

**iOS**
<LinkCard title="setUserId – iOS" href="https://github.com/Pushwoosh/pushwoosh-ios-sdk/blob/master/Documentation/PushNotificationManager.md#1ad51b323a64cbedb408442f9b52cc39fd" />


#### Método de la API `registerUser`

Este método le permite asignar de forma remota un ID de usuario a un HWID específico desde su backend.

Puede encontrar información detallada sobre el uso de esta llamada a la API [aquí](/es/developer/api-reference/user-centric-api#registeruser).

### Registro con Solitics

Cuando un usuario se registra para recibir mensajes push, también se debe informar a Solitics. Para ello, realice la siguiente solicitud HTTP:

**Método HTTP:** POST

**Endpoint:** `https://api.solitics.com/rest/subscribers/register/app`

**Cuerpo de la solicitud**

```json
{
 "memberId": "1234567",
 "email": "abcd@solitics.com",
 "token": "GH2TKoXXXXXXXEj1111",
 "key": "1234567”
}
```

**Parámetros del cuerpo**

| Parámetro  | Descripción                                                                                       |
| ---------- | ------------------------------------------------------------------------------------------------- |
| memberID   | Representa el identificador único del usuario en Solitics (como el ID del CRM)                |
| email      | El correo electrónico del miembro que se utiliza para la autenticación de dos factores                                     |
| token      | El token proporcionado por Solitics para obtener acceso a la API de push.                                     |
| key        | La clave de registro push del miembro debe coincidir con el ID de usuario utilizado para el registro con Pushwoosh. |

Aunque Solitics recomienda utilizar el ID de miembro como clave, pueden aplicarse excepciones. Por ejemplo, si se utilizan varias aplicaciones en Pushwoosh, se debe asignar una clave diferente al usuario para cada aplicación.

## Prueba de la integración

Una vez que haya completado el proceso de configuración, es crucial realizar una prueba para asegurarse de que la integración funciona como se espera. Siga estos pasos para la prueba:

1. Cree una Promoción Push en Solitics y guárdela.

2. Inicie sesión en su aplicación o sitio. Acceda a la aplicación o sitio web donde espera que aparezca el mensaje push. Asegúrese de iniciar sesión en la cuenta de usuario que ha sido registrada previamente para recibir notificaciones push tanto en Solitics como en Pushwoosh.

Si no está seguro del estado del registro, no dude en ponerse en contacto con Solitics en [support@solitics.com](mailto:support@solitics.com) para confirmarlo, incluyendo detalles sobre el estado de registro del usuario y el ID de usuario asociado.

3. Inicie la prueba. En la promoción de Solitics, haga clic en el botón Probar. Introduzca el correo electrónico, el número de teléfono o el ID de miembro del suscriptor (el destinatario previsto del mensaje push). Haga clic en Enviar.

Si todas las configuraciones son correctas, el mensaje push debería aparecer.