# Integração com Solitics

<Aside type="caution" icon="setting" title="Necessária a ajuda do desenvolvedor">
 Você precisará da ajuda da sua equipe de desenvolvimento para configurar a integração. Por favor, compartilhe este guia com eles.
</Aside>

[Solitics](https://solitics.com/) é uma plataforma avançada de gerenciamento de dados e automação de marketing em tempo real que capacita marcas B2C a oferecer experiências altamente personalizadas aos seus clientes. Ao aproveitar os dados dos clientes, as empresas podem aumentar a receita por meio de melhores taxas de conversão e retenção, tudo isso enquanto reduzem significativamente as despesas com desenvolvimento e TI.

Quando combinadas com o Pushwoosh, as capacidades de gerenciamento de dados do Solitics permitem que as marcas entreguem mensagens altamente direcionadas e relevantes aos seus usuários. Isso garante que os usuários recebam conteúdo e ofertas que são adaptados especificamente aos seus interesses e necessidades, melhorando assim sua experiência geral.

As marcas também podem usar o Solitics para analisar dados de usuários e identificar áreas de melhoria na jornada do usuário. Ao integrar esses dados com o Pushwoosh, as marcas podem enviar notificações push para reengajar usuários que possam ter abandonado sua jornada, direcionando-os de volta ao aplicativo ou site e, em última análise, melhorando as taxas de conversão.

## Casos de uso

Abaixo estão alguns casos de uso práticos que demonstram como a integração do Solitics e do Pushwoosh pode ser usada para melhorar a experiência do cliente e impulsionar os resultados de negócios:

### Promoções e ofertas personalizadas

As empresas podem usar os dados do Solitics para analisar as preferências e comportamentos dos clientes. Em seguida, podem enviar notificações push personalizadas através do Pushwoosh com promoções e ofertas adaptadas com base nos interesses individuais.

### Aumentando o engajamento

Empresas de jogos podem configurar o Solitics para monitorar as ações e conquistas dos jogadores, e então utilizar o Pushwoosh para entregar prontamente notificações push sobre marcos e eventos especiais aos jogadores, incentivando o engajamento ativo e a participação em atividades específicas do jogo.

### Alertas de segurança

Aplicativos bancários podem manter seus clientes confiantes na segurança de seus dados graças à integração Solitics + Pushwoosh. Eles podem configurar o Solitics para monitorar a atividade da conta e acionar alertas para comportamentos incomuns. Em seguida, podem usar o Pushwoosh para entregar notificações push em tempo real para notificar os clientes afetados, incentivando uma ação rápida para proteger suas contas e prevenir possíveis problemas.

## Configurando a integração

O processo de integração envolve duas etapas principais:

1. Incorporar o SDK do Pushwoosh em seu site ou aplicativo móvel.
2. Estabelecer um ID de usuário que sirva como um identificador único tanto para o Solitics quanto para o Pushwoosh.

### Pré-requisitos

1. Conta Pushwoosh
2. [Token de Acesso à API do Pushwoosh](/pt/developer/api-reference/api-access-token): Para permitir a transmissão de dados para o Pushwoosh, você precisa gerar um token de Acesso à API do Pushwoosh. Para obtê-lo, vá para **Configurações > Acesso à API** e copie-o de lá.
3. Código do Aplicativo Pushwoosh: Da mesma forma, você precisará localizar o Código do seu Aplicativo Pushwoosh para facilitar a transferência de dados para o Pushwoosh. Para fazer isso, encontre o nome do projeto no canto superior esquerdo e copie o código exibido abaixo dele.
4. [Conta Solitics](https://dashboard.solitics.com/#/pages/signin)

<Aside type="note">
Para habilitar a integração, registre cada usuário tanto no Solitics quanto no Pushwoosh usando o mesmo ID de membro. Este é o requisito principal para que a integração funcione de forma eficaz.
</Aside>

### Configurando o Pushwoosh para a integração

1. Crie uma conta no Pushwoosh se você ainda não tiver uma.
2. Configure seus projetos. [Saiba mais sobre como fazer isso.](/pt/product/first-steps/start-with-your-project/configure-platforms)
3. Em seguida, crie um aplicativo no Pushwoosh e selecione os canais de comunicação preferidos. Você pode optar por usar um aplicativo existente se já tiver um.

### Configurando o Solitics para a integração

1. Entre em contato com o Solitics ([support@solitics.com](mailto:support@solitics.com)) e peça para integrar sua marca com o Pushwoosh.

Especifique os seguintes detalhes:

* Chave da API do Pushwoosh
* Código do Aplicativo Pushwoosh

2. A equipe do Solitics fornecerá a você um token de acesso para futuras interações com a API do Solitics.

## Registro de usuário

Como enfatizado anteriormente, é importante registrar os usuários com IDs de usuário idênticos tanto no Solitics quanto no Pushwoosh.

<Aside type="note">
Use o mesmo ID de membro único que sua marca usa para a integração de membros ao se registrar para notificações push. Essa consistência não apenas garantirá que seu ID de membro seja único, mas também otimizará o rastreamento e facilitará a depuração em caso de problemas.
</Aside>

### Registro com o Pushwoosh

O Pushwoosh oferece dois métodos para associar um ID de usuário a um dispositivo específico. Se você não usar esses métodos, o Pushwoosh empregará automaticamente o ID de hardware do dispositivo como o identificador do usuário.

Para vincular um ID de usuário a um dispositivo no Pushwoosh, você pode escolher um dos seguintes métodos:

#### `setUserId`

Esta é uma função do SDK que permite definir um valor de string como um ID do Pushwoosh, que será automaticamente correspondido com um ID de Hardware (HWID) usado pelo 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 da API `registerUser`

Este método permite que você atribua remotamente um ID de Usuário a um HWID específico a partir do seu backend.

Informações detalhadas sobre o uso desta chamada de API podem ser encontradas [aqui](/pt/developer/api-reference/user-centric-api#registeruser).

### Registro com o Solitics

Quando um usuário é registrado para receber mensagens push, o Solitics também precisa ser informado. Para isso, faça a seguinte requisição HTTP:

**Método HTTP:** POST

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

**Corpo da solicitação**

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

**Parâmetros do corpo**

| Parâmetro  | Descrição                                                                                         |
| ---------- | ------------------------------------------------------------------------------------------------- |
| memberID   | Representa o identificador único do usuário no Solitics (como o ID do CRM)                        |
| email      | O e-mail do membro que é usado para autenticação de dois fatores                                  |
| token      | O token fornecido pelo Solitics para obter acesso à API de push.                                  |
| key        | A chave de registro de push do membro deve corresponder ao ID de usuário usado para o registro com o Pushwoosh. |

Embora o Solitics recomende o uso do ID do membro como a chave, exceções podem ser aplicadas. Por exemplo, se vários aplicativos forem usados no Pushwoosh, uma chave diferente deve ser atribuída ao usuário para cada aplicativo.

## Testando a integração

Depois de concluir o processo de configuração, é crucial realizar um teste para garantir que a integração funcione como esperado. Siga estas etapas para o teste:

1. Crie uma Promoção Push no Solitics e Salve.

2. Faça login no seu aplicativo ou site. Acesse o aplicativo ou site onde você espera que a mensagem push apareça. Certifique-se de fazer login na conta de usuário que foi previamente registrada para notificações push tanto no Solitics quanto no Pushwoosh.

Se você não tiver certeza sobre o status do registro, sinta-se à vontade para entrar em contato com o Solitics em [support@solitics.com](mailto:support@solitics.com) para confirmação, incluindo detalhes sobre o status de registro do usuário e o ID de usuário associado.

3. Inicie o teste. Na promoção do Solitics, clique no botão Testar. Insira o e-mail, número de telefone ou ID de membro do assinante (o destinatário pretendido da mensagem push). Clique em Enviar.

Se todas as configurações estiverem corretas, a mensagem push deverá aparecer.