# Registrar dispositivos no Pushwoosh e sincronizar dados com a plataforma

Para segmentar e engajar usuários de forma eficaz através do Pushwoosh, é crucial garantir que os dispositivos dos usuários estejam devidamente registrados e que seus dados estejam sincronizados. Existem vários métodos para registrar dispositivos e sincronizar dados com o Pushwoosh, dependendo de suas necessidades específicas.

## SDK do Pushwoosh

### Mobile

Para aplicativos móveis, a integração do SDK do Pushwoosh é o método recomendado para um registro de dispositivo e sincronização de dados contínuos entre o aplicativo, os sistemas Pushwoosh e, opcionalmente, sistemas de terceiros que os clientes possam usar para pipelines de dados ou fluxos de trabalho específicos.

Ao integrar o SDK, você pode automatizar o processo de registro de dispositivos e gerenciamento de seus tokens de push. O SDK chama internamente o método da API registerDevice, garantindo que cada dispositivo seja registrado e sincronizado com o Pushwoosh sem exigir qualquer intervenção manual.

Além disso, o SDK do Pushwoosh permite o registro de números de telefone para notificações por SMS e WhatsApp. Você pode usar os seguintes métodos:

#### Registrar um número de SMS

##### iOS

```
- (void)registerSmsNumber:(NSString * _Nonnull)number;
```

**Exemplo**

```
Pushwoosh.sharedInstance().registerSmsNumber(@"+0000000000");
```

Substitua `+0000000000` pelo número de telefone real no **formato E.164** (incluindo o sinal “+” e o código do país).

##### Android

```
Pushwoosh.getInstance().registerSmsNumber(String number);
```

**Exemplo**

```
Pushwoosh.getInstance().registerSmsNumber("+0000000000");
```

Substitua `+0000000000` pelo número de telefone real do usuário no formato E.164, incluindo o “+” e o código do país.

#### Registrar um número de WhatsApp

##### iOS

```
- (void)registerWhatsappNumber:(NSString * _Nonnull)number;
```

**Exemplo**

```
Pushwoosh.sharedInstance().registerWhatsappNumber(@"+0000000000");
```

Substitua `+0000000000` pelo número de telefone real no **formato E.164** (incluindo o sinal “+” e o código do país).

##### Android

Para registrar o número de telefone de um usuário para o WhatsApp no Android, use o seguinte método:

```
Pushwoosh.getInstance().registerWhatsappNumber(String number);
```

**Exemplo**

```
Pushwoosh.getInstance().registerWhatsappNumber("+0000000000");
```

Substitua `+0000000000` pelo número de telefone real do usuário no formato E.164, incluindo o “+” e o código do país.

### Web

Para registrar dispositivos para pushes da web, use o [SDK de Push para Web](/pt/developer/pushwoosh-sdk/web-push-notifications/web-push-sdk-30/).

<Aside type="tip">
Para permitir que os visitantes do seu site optem por receber notificações push, configure um [Prompt de Inscrição](/pt/developer/guides/messaging-channels/subscription-prompt/) personalizado ou padrão em seu site. Este prompt aciona a solicitação de inscrição nativa do navegador, onde os usuários podem optar por ativar ou bloquear as notificações push da web para o seu site.
</Aside>
<video src="/start-with-your-project-subscribe-users-1.webm" title="Exemplo de prompt de inscrição de push da web mostrando a solicitação de permissão de notificação do navegador" autoplay loop muted playsinline />

[Saiba mais sobre o SDK do Pushwoosh](/pt/developer/pushwoosh-sdk/pushwoosh-sdk-overview)

## API do Pushwoosh

Além disso, você pode usar a **API do Pushwoosh** para registrar dispositivos e sincronizar dados. A API oferece total flexibilidade para cenários mais avançados.

### Mobile

Para registrar dispositivos móveis, use o método da API [`registerDevice`](/pt/developer/api-reference/device-api/#registerdevice).

### E-mail

O Pushwoosh fornece formulários de inscrição integrados que você pode incorporar em seu site para coletar inscrições de e-mail. Saiba como [criar e incorporar um formulário](/pt/product/audience-data-and-segmentation/subscription-forms/create-subscription-forms/#how-to-build-a-form) e [personalizar o widget](/pt/product/audience-data-and-segmentation/subscription-forms/customize-widget/#customize-colors).

Após coletar os e-mails, use o método da API [`registerEmail`](/pt/developer/api-reference/email-api#registeremail) para registrar dispositivos de e-mail. Alternativamente, você pode usar [`registerDevice`](/pt/developer/api-reference/device-api#registerdevice).

<Aside type="note">
Observe que a solicitação [`registerEmailUser`](/pt/developer/api-reference/email-api#registeremailuser) não registra um endereço de e-mail em sua base de usuários; ela deve ser usada apenas para atribuir User IDs a e-mails já registrados pela chamada registerEmail.
</Aside>

Para associar os usuários do seu aplicativo ou visitantes do site aos seus endereços de e-mail, use os [User IDs](/pt/developer/pushwoosh-knowledge-hub/users-userids/users-userids). Isso permite que você crie Customer Journeys entre canais e envie e-mails com base nas ações do usuário em seu aplicativo ou no site. O User ID também permitirá que você visualize o histórico de mensagens e eventos do usuário no User Explorer.

**1**. **Obtenha o User ID.**

Cada dispositivo registrado para o seu projeto Pushwoosh tem seu User ID; por padrão, ele é igual ao ID de hardware do dispositivo (HWID) e é recuperado pela solicitação da API [`registerDevice`](/pt/developer/api-reference/device-api#registerdevice).

Para definir um User ID personalizado, chame o método [`registerUser`](/pt/developer/api-reference/user-centric-api#registeruser).

**2. Atribua o User ID a um endereço de e-mail.**

Use o método da API [`registerEmail`](/pt/developer/api-reference/email-api#registeremail) ou [`registerEmailUser`](/pt/developer/api-reference/email-api#registeremailuser) para associar o User ID a um endereço de e-mail.

[Saiba mais sobre User IDs](/pt/developer/pushwoosh-knowledge-hub/users-userids/users-userids)

### SMS

Para registrar dispositivos SMS no Pushwoosh, você pode usar o método da API [`registerDevice`](/pt/developer/api-reference/device-api#registerdevice) ou o método da API [`createSMSMessage`](/pt/developer/api-reference/sms#createsmsmessage). Ao usar o último, certifique-se de definir o parâmetro `use_auto_registration` como `true` para registrar automaticamente o número de telefone como um dispositivo SMS. [Saiba mais](/pt/developer/api-reference/sms#createsmsmessage)

### WhatsApp

Para registrar dispositivos WhatsApp no Pushwoosh, você pode usar o método da API [`registerDevice`](/pt/developer/api-reference/device-api#registerdevice) ou o método da API [`createWhatsAppMessage`](/pt/developer/api-reference/whatsapp). Ao usar o último, certifique-se de definir o parâmetro `use_auto_registration` como `true` para registrar automaticamente o número de telefone como um dispositivo WhatsApp.

## Importando sua base de usuários existente

Se você estiver trabalhando com grandes conjuntos de dados pré-existentes, pode importar esses dados para o Pushwoosh.

### Mobile

Para migrar sua base de assinantes de push Mobile, entre em contato conosco através do [formulário de Contato](https://help.pushwoosh.com/hc/en-us/requests/new) e forneça uma amostra de sua base de usuários. Nossa equipe revisará o formato dos dados e avaliará se a migração é viável.

### Web

Usuários da web não podem ser importados devido a limitações técnicas. Diferentes provedores de push usam formatos de payload e configurações de plataforma variados, tornando a importação de usuários da web ineficaz. Como resultado, a base de usuários importada seria invalidada ou receberia conteúdo incorreto ou em branco.

No entanto, usuários da web que já deram permissão para receber notificações push para o seu site podem ser reinscritos. [Saiba mais](https://help.pushwoosh.com/hc/en-us/articles/360018326111-Migrate-your-userbase-to-Pushwoosh/?utm_content=docs&utm_term=post&utm_campaign=migrate-your-userbase-to-pushwoosh)

### E-mail

Para [importar seu banco de dados de assinantes de e-mail](/pt/product/messaging-channels/emails/get-email-subscribers/#import-email-list), envie um arquivo **.csv** com os endereços de e-mail. Os e-mails importados serão registrados como assinantes na plataforma de e-mail. Você também pode enviar dados adicionais para cada endereço de e-mail, como o nome, gênero ou localização do destinatário, para segmentar e personalizar melhor suas comunicações por e-mail.

[Importar e-mails](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-emails)

### SMS

Importe um arquivo **.csv** com números de telefone para assinantes de SMS. Você pode fornecer dados adicionais, como o nome, gênero ou localização do destinatário, para segmentar e personalizar ainda mais suas comunicações por SMS.

[Importar contatos de SMS](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-sms)

### WhatsApp

Para importar seus contatos do WhatsApp, envie um arquivo .csv com os contatos do WhatsApp. Você também pode fornecer detalhes extras, como o nome, gênero ou localização do destinatário, para personalizar suas mensagens do WhatsApp.

[Importar contatos do WhatsApp](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-whatsapp)

### Viber

Para importar seus contatos do Viber, envie um arquivo .csv com os contatos do Viber. Você também pode fornecer detalhes extras, como o nome, gênero ou localização do destinatário, para personalizar suas mensagens do Viber.

[Importar contatos do Viber](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-viber)

## Usando integrações de terceiros para transferir dados

Além do SDK e da API, o Pushwoosh oferece várias integrações de terceiros para ajudá-lo a sincronizar e transferir dados de outras plataformas, facilitando o gerenciamento de usuários e dados em vários sistemas.

[Explore todas as integrações disponíveis](/pt/product/integrations/)