# Guia de configuração de projeto

Este guia descreve os passos para configurar seu projeto Pushwoosh e canais de mensagens como notificações push, caixa de entrada de mensagens, mensagens in-app, e-mail, WhatsApp, LINE, Kakao, SMS e passes da Apple e Google Wallet. Dependendo do canal, você configurará as definições da plataforma, integrará SDKs (se necessário) e registrará os dados do usuário.

Uma vez que um canal esteja configurado, você pode começar a enviar mensagens através do Painel de Controle da Pushwoosh ou via API.

## Pré-requisitos

Antes de começar a trabalhar com qualquer canal de comunicação, complete estes passos:

*   **Crie uma conta Pushwoosh**

*   **Use seu projeto padrão ou crie um novo**
    Um projeto padrão (**My project**) é criado quando você se registra. Use-o para um aplicativo em várias plataformas ou crie projetos separados para diferentes aplicativos
    <LinkCard title="Aprenda como criar um projeto" href="/product/first-steps/start-with-your-project/create-your-project/" />

## Configure os canais de mensagens

<TitleIcon icon="push">
### Notificações push
</TitleIcon>

Envie alertas oportunos e personalizados para usuários em plataformas móveis e web.

Para habilitar as notificações push:

<Steps>
1. **Configure sua plataforma**

   Configure as credenciais para iOS, Android, Huawei e Web. [Saiba mais](/pt/developer/first-steps/connect-messaging-services/configure-project/)

2. **Integre o SDK**

   Adicione o SDK da Pushwoosh ao seu aplicativo ou site. [Saiba mais](/pt/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **Teste a integração e publique seu aplicativo ou site**

   Garanta que a funcionalidade de push funcione como esperado.
   * Para aplicativos, lance a versão com o SDK integrado nas lojas de aplicativos.
   Para sites, apenas atualize seu site ao vivo. [Saiba mais](/pt/developer/first-steps/test-your-integration/test-devices/)

4. **Registre os usuários**

   Inscreva dispositivos e sincronize os dados do usuário para habilitar a entrega de push. [Saiba mais](/pt/developer/first-steps/subscribe-users/)

5. **Defina User IDs personalizados**

   Atribua um User ID personalizado para unificar os dispositivos/contatos de uma pessoa sob um único perfil. [Saiba mais](/pt/developer/first-steps/collecting-user-ids/)
</Steps>

Uma vez que a configuração esteja completa, você pode começar a [enviar notificações push através do Painel de Controle](/pt/product/messaging-channels/push-notifications/#start-sending-different-types-of-push-notifications) ou usar o método da API [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="download">
### Caixa de entrada de mensagens
</TitleIcon>

Armazene mensagens importantes em um espaço dedicado no aplicativo para alcançar os usuários mesmo que eles optem por não receber notificações push.

Para habilitar a Caixa de entrada de mensagens:

<Steps>
1. **Configure as plataformas**

   Configure seu aplicativo para mensagens push nas plataformas suportadas. [Saiba mais](/pt/developer/first-steps/connect-messaging-services/configure-project/)

2. **Integre o SDK**

   Adicione o SDK da Pushwoosh ao seu aplicativo para habilitar a funcionalidade da caixa de entrada. [Saiba mais](/pt/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **Registre os usuários**

   Sincronize os dados do usuário para permitir a entrega de mensagens na caixa de entrada. [Saiba mais](/pt/developer/first-steps/subscribe-users/)

4. **Defina User IDs personalizados**

   Atribua um User ID personalizado para unificar os dispositivos/contatos de uma pessoa sob um único perfil. [Saiba mais](/pt/developer/first-steps/collecting-user-ids/)

5. **Implemente a Caixa de entrada de mensagens**

   Siga os guias específicos da plataforma para implementar a interface da caixa de entrada. [Saiba mais](/pt/developer/guides/message-inbox/)

6. **Personalize a UI (opcional)**

   Personalize a aparência da caixa de entrada conforme necessário. [Saiba mais](/pt/developer/guides/message-inbox/)
</Steps>

Uma vez que a integração esteja completa, você pode entregar mensagens na caixa de entrada usando a [Jornada do Cliente Pushwoosh](/pt/product/customer-journey/journey-elements/#save-to-inbox) ou o método da API [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="inapp">
### Mensagens in-app
</TitleIcon>

Exiba mensagens contextuais diretamente dentro do seu aplicativo.

Para habilitar as mensagens in-app:

<Steps>
1. **Configure sua plataforma**

   Garanta que seu aplicativo suporte mensagens in-app. [Saiba mais](/pt/developer/first-steps/connect-messaging-services/configure-project/)

2. **Integre o SDK**

   Necessário para a entrega de mensagens in-app. [Saiba mais](/pt/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **Teste a integração e publique seu aplicativo**

   Garanta que a funcionalidade in-app funcione como esperado e lance a versão com o SDK integrado nas lojas de aplicativos. [Saiba mais](/pt/developer/first-steps/test-your-integration/)

4. **Registre os usuários**

   Garanta que os dispositivos estejam inscritos e os dados do usuário sincronizados. [Saiba mais](/pt/developer/first-steps/subscribe-users/)

5. **Defina User IDs personalizados**

   Atribua um User ID personalizado para unificar os dispositivos/contatos de uma pessoa sob um único perfil. [Saiba mais](/pt/developer/first-steps/collecting-user-ids/)
</Steps>

Após a configuração, você pode enviar mensagens in-app via [Jornada do Cliente](/pt/product/messaging-channels/in-apps/sending-in-apps/#send-in-apps-via-customer-journey) ou usar a funcionalidade de [In-apps Instantâneos](/pt/product/messaging-channels/in-apps/sending-in-apps/#send-instant-in-apps).

<TitleIcon icon="email">
### E-mails
</TitleIcon>

Alcance seus usuários com campanhas de e-mail personalizadas ou mensagens transacionais.

Para começar a enviar e-mails:

<Steps>
1. **Configure a plataforma de e-mail**

   Autentique seu domínio e endereço de remetente. [Saiba mais](/pt/developer/first-steps/connect-messaging-services/email-verification/)

2. **Registre os usuários**

   Importe e sincronize os endereços de e-mail dos usuários. [Saiba mais](/pt/developer/first-steps/subscribe-users/)

3. **Defina User IDs personalizados**

   Atribua um User ID personalizado para unificar os dispositivos/contatos de uma pessoa sob um único perfil. [Saiba mais](/pt/developer/first-steps/collecting-user-ids/)
</Steps>

Uma vez que a configuração esteja completa, você pode começar a enviar e-mails usando o Painel de Controle da Pushwoosh ou o método [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="whatsapp">
### WhatsApp
</TitleIcon>

Engaje os usuários em um dos aplicativos de mensagens mais usados do mundo, entregando mensagens seguras e aprovadas que impulsionam interações significativas.

Para habilitar as mensagens do WhatsApp:

<Steps>
1. **Conecte sua conta do WhatsApp Business**

   [Saiba mais](/pt/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration/)

2. **Aprove os modelos**

   Envie seus próprios modelos para a Meta ou use os pré-aprovados. [Saiba mais](/pt/product/messaging-channels/whatsapp-messages/#create-whatsapp-templates)

3. **Registre os contatos do WhatsApp**

   [Saiba mais](/pt/developer/first-steps/subscribe-users/)

4. **Defina User IDs personalizados**

   Atribua um User ID personalizado para unificar os dispositivos/contatos de uma pessoa sob um único perfil. [Saiba mais](/pt/developer/first-steps/collecting-user-ids/)
</Steps>

Uma vez que a integração esteja pronta, você pode enviar mensagens do WhatsApp [usando o Painel de Controle](/pt/product/messaging-channels/whatsapp-messages/send-whatsapp-messages/) ou o método da API [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="sms">
### SMS
</TitleIcon>

Envie mensagens de texto diretamente para os números de celular dos usuários.

Para habilitar o SMS:

<Steps>
1. **Conecte seu provedor de SMS**

   [Saiba mais](/pt/developer/first-steps/connect-messaging-services/sms-configuration/)

   Para URLs de callback do provedor, consulte [Webhooks do provedor de SMS](/pt/developer/first-steps/connect-messaging-services/sms-configuration/sms-provider-webhooks/).

2. **Registre os números de telefone**

   Colete e formate os números corretamente (E.164) com o consentimento do usuário. [Saiba mais](/pt/developer/first-steps/subscribe-users/)

3. **Defina User IDs personalizados**

   Atribua um User ID personalizado para unificar os dispositivos/contatos de uma pessoa sob um único perfil. [Saiba mais](/pt/developer/first-steps/collecting-user-ids/)
</Steps>

Após a configuração, você pode enviar mensagens SMS usando a [Jornada do Cliente](/pt/product/customer-journey/journey-elements/#sms), ou via o método da API [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="line">
### LINE
</TitleIcon>

Use o LINE para se conectar com os usuários via Jornadas do Cliente, API ou chat 1:1, usando modelos ou mensagens de texto simples.
Para começar a usar as mensagens do LINE:

<Steps>

1.  **Configure suas contas do LINE**
    Crie uma [Conta Oficial de Negócios do LINE](https://www.linebiz.com/jp-en/) e uma [Conta de Desenvolvedores do LINE](https://developers.line.biz/en/docs/line-developers-console/login-account/).

2.  **Conecte o LINE à Pushwoosh**
    Configure a plataforma LINE na sua conta Pushwoosh. [Saiba mais](/pt/developer/first-steps/connect-messaging-services/line-configuration/)

3.  **Certifique-se de que o LINE Messaging está configurado e o faturamento está ativado.**
    > **Importante:** O preço da API de Mensagens do LINE é gerenciado diretamente pelo LINE. Os planos variam por região e volume de uso. [Ver detalhes de preços](https://developers.line.biz/en/docs/messaging-api/pricing/)

</Steps>

##### Próximos passos

*   **Envie mensagens via API**

    Use a API da Pushwoosh para enviar mensagens do LINE com conteúdo de modelo ou texto simples.

    <LinkCard title="Notify" href="/developer/api-reference/messaging-api-v2/notify/" />

<TitleIcon icon="comment">
### Kakao
</TitleIcon>

Envie mensagens Kakao via Jornadas do Cliente ou API usando modelos aprovados para alcançar usuários no KakaoTalk.

Para começar a usar as mensagens do Kakao:

<Steps>

1.  **Conecte o Kakao à Pushwoosh**

    Configure a plataforma Kakao na sua conta Pushwoosh. [Saiba mais](/pt/developer/first-steps/connect-messaging-services/kakao-configuration/)

2.  **Crie e aprove modelos de mensagem**

    Use modelos Kakao aprovados; modelos personalizados requerem aprovação no Kakao Business Center. [Saiba mais](/pt/product/content/kakao-presets/)

</Steps>

##### Próximos passos

*   **Envie mensagens via API**

    Use a API da Pushwoosh para enviar mensagens do Kakao com modelos aprovados.

    <LinkCard title="Notify" href="/developer/api-reference/messaging-api-v2/notify/" />

### Passes da Apple Wallet

Crie passes da Apple Wallet, incluindo cartões de fidelidade, cupons, ingressos para eventos e muito mais, e envie atualizações ao vivo para cada dispositivo que os adicionou.

Para começar a usar os passes da Apple Wallet:

<Steps>

1.  **Configure o certificado de assinatura**

    Adicione seu certificado de ID de Tipo de Passe da Apple ao seu aplicativo para que a Pushwoosh possa assinar os passes. [Saiba mais](/pt/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2.  **Crie e emita um passe**

    Construa um passe no construtor de passes e, em seguida, compartilhe-o como um link de instalação ou código QR. [Saiba mais](/pt/product/messaging-channels/apple-wallet-passes/pass-builder/)

</Steps>

##### Próximos passos

*   **Saiba mais sobre os passes da Apple Wallet**

    Crie, distribua e atualize passes no Painel de Controle.

    <LinkCard title="Saiba mais" href="/product/messaging-channels/apple-wallet-passes/" />

*   **Gerencie passes via API**

    Use a API PassKit para criar, atualizar e gerenciar passes programaticamente.

    <LinkCard title="Saiba mais" href="/developer/api-reference/apple-wallet-passkit-api/" />

### Passes da Google Wallet

Crie passes da Google Wallet, incluindo cartões de fidelidade, ofertas, ingressos para eventos e muito mais, e deixe o Google sincronizar as atualizações para cada dispositivo que os salvou.

Para começar a usar os passes da Google Wallet:

<Steps>

1.  **Configure a Google Wallet na Pushwoosh**

    Adicione seu ID de Emissor e a chave da conta de serviço ao seu aplicativo. Esta configuração é independente do Firebase. [Saiba mais](/pt/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)

2.  **Crie e emita um passe**

    Construa um passe no construtor de passes e, em seguida, compartilhe um link para salvar "Adicionar à Google Wallet" ou um código QR. [Saiba mais](/pt/product/messaging-channels/google-wallet-passes/pass-builder/)

</Steps>

##### Próximos passos

*   **Distribua e atualize passes no Painel de Controle**

    <LinkCard title="Saiba mais" href="/product/messaging-channels/google-wallet-passes/" />

*   **Envie mensagens aos portadores de passes**

    Alcance os portadores com atualizações de passes, push único ou Jornada do Cliente.

    <LinkCard title="Saiba mais" href="/product/messaging-channels/google-wallet-passes/message-pass-holders/" />

*   **Gerencie passes via API**

    Use a API da Google Wallet para criar passes, emitir links para salvar e enviá-los aos usuários.

    <LinkCard title="Saiba mais" href="/developer/api-reference/google-wallet-api/" />

## Crie campanhas omnichannel

Depois de configurar e integrar os canais de mensagens necessários, você pode criar campanhas omnichannel para coordenar a comunicação em vários pontos de contato.

Para habilitar a funcionalidade omnichannel, certifique-se de registrar e associar os dados do usuário (por exemplo, ID do dispositivo, e-mail, número de telefone) sob um [User ID unificado](/pt/developer/pushwoosh-knowledge-hub/users-userids/). Isso permite que você se dirija ao mesmo usuário em diferentes canais a partir de uma única lógica de campanha.

<LinkCard title="Saiba mais sobre campanhas omnichannel" href="/product/pushwoosh-knowledge-hub/omnichannel-campaigns/" />