> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress

> Guia completo de configuração e migração para o OneSignal WordPress Web Push Plugin v3+. Configure notificações push, prompts e segmentação através do painel do OneSignal com processo de configuração simplificado.

## Visão Geral

Este guia cobre como configurar e usar o OneSignal WordPress Web Push Plugin v3+.

<Info>
  Para a documentação do WordPress versão 2.x.x mais antiga, consulte [Plugin WordPress Legacy](./wordpress-legacy).
</Info>

### Novidades na Versão 3+

Esta versão marca uma atualização significativa ao simplificar o processo de configuração. Com a Versão 3+, você pode gerenciar todas as suas configurações de prompt em um só lugar—o Painel do OneSignal.

* 🚀 **Atualização do SDK**: Atualiza o OneSignal Web SDK da versão 15 para 16
* 💬 **Prompts no Painel**: Configure todos os [prompts de permissão](./permission-requests) diretamente no painel do OneSignal—sem necessidade de código customizado
* ⏩ **Publicação com Um Clique**: Marque "Enviar notificação quando o post for publicado" para enviar notificações push automaticamente
* 🧑‍🤝‍🧑 **Segmentação de Audiência**: Escolha quais [segmentos](./segmentation) recebem notificações para cada post
* 📲 **Integração com App Mobile**: Envie para assinantes de aplicativos móveis com [deep linking](./links#deep-linking) opcional

<Info>
  Para a documentação do WordPress versão 2.x.x mais antiga, consulte [Plugin WordPress Legacy](./wordpress-legacy).
</Info>

***

## Configuração

Antes de começar, certifique-se de ter:

* [Conta OneSignal](https://dashboard.onesignal.com/signup) (grátis para criar)
* Acesso de administrador do WordPress para instalar e configurar plugins
* Site com HTTPS habilitado (necessário para notificações push web)

### 1. Configure o WordPress no Painel do OneSignal

Navegue até **Settings > Push & In-App > Web > WordPress Plugin or Website Builder**

<Frame caption="Selecione WordPress nas opções de Website Builder no seu painel do OneSignal">
  <img src="https://mintcdn.com/onesignal/sCO1i1UqrWQxmZ28/images/dashboard/wordpress-integration-selection.png?fit=max&auto=format&n=sCO1i1UqrWQxmZ28&q=85&s=d48170c90c2d9e309769c430c1f8336d" width="1916" height="590" data-path="images/dashboard/wordpress-integration-selection.png" />
</Frame>

#### Configuração do site

* **Site Name**: O nome do seu site e título padrão de notificação.
* **Site URL**: Deve corresponder exatamente à URL do seu site WordPress (siga a [política de mesma origem](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy))
* **Auto Resubscribe**: Ative isso para reinscrever automaticamente usuários que limparam os dados do navegador quando retornarem ao seu site (sem necessidade de novo prompt de permissão)
* **Default Icon URL**: Arquivo PNG ou JPG quadrado de `256x256px` para notificações e prompts – MacOS Safari não mostrará um prompt de notificação sem um ícone.

<Frame caption="Digite sua URL exata do site. https://seu-site.com é diferente de https://www.seu-site.com—use apenas um formato de forma consistente">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5a29a00c2808e8128e2cd822d743d14b472637f65fbde2aa64d9f16a8658d4a6-Screenshot_2025-02-13_at_3.06.28_PM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=535d1d4b6d579d0d296fbed60d5d669b" width="2046" height="1036" data-path="images/docs/5a29a00c2808e8128e2cd822d743d14b472637f65fbde2aa64d9f16a8658d4a6-Screenshot_2025-02-13_at_3.06.28_PM.png" />
</Frame>

<Info>
  Testando localmente? Consulte o [Guia de Testes Locais](./web-sdk-setup#local-testing) para desenvolvimento em localhost
</Info>

#### Prompts de permissão

Configure seus [prompts de permissão](./permission-requests) para Push, Email e/ou SMS. O Push Slide Prompt está habilitado por padrão, mas você pode personalizar ou adicionar prompts adicionais.

<Info>
  **Dica Profissional**: Comece com prompts simples e adicione complexidade gradualmente. Você pode
  modificar todas as configurações de prompt a qualquer momento através do painel do OneSignal. Explore
  todas as opções disponíveis em [Prompts de permissão web](./permission-requests).
</Info>

<Tabs>
  <Tab title="Configuração Básica de Prompt">
    <Steps>
      <Step title="Clique no Push Slide Prompt para personalizar">
        <Frame caption="Acesse e personalize as configurações do seu push slide prompt">
          <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/32d2f36e12becd930037774ab376b1c65080fbb801e99f37f00964603371614e-Screenshot_2025-02-13_at_3.39.15_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=fffa465720f34780e7c22b047a57ca4e" width="2534" height="452" data-path="images/docs/32d2f36e12becd930037774ab376b1c65080fbb801e99f37f00964603371614e-Screenshot_2025-02-13_at_3.39.15_PM.png" />
        </Frame>
      </Step>

      <Step title="Configure o tempo e o texto:">
        * Defina **Auto Prompt** para `1` visualização de página e `1` segundo para testes iniciais
          * Personalize o texto e a aparência do prompt
          * Ajuste o tempo com base no comportamento do usuário após o lançamento

        <Frame caption="Configure o tempo do auto-prompt e personalize a aparência do prompt">
          <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3f3638ec5fa60f55fb8aa922ba0f7197aee508f11b242e0377a0a8e255a2b38d-Screenshot_2025-02-13_at_3.42.09_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=33f5eb55da0cee00d1d8121bb3f66f89" width="1922" height="1594" data-path="images/docs/3f3638ec5fa60f55fb8aa922ba0f7197aee508f11b242e0377a0a8e255a2b38d-Screenshot_2025-02-13_at_3.42.09_PM.png" />
        </Frame>
      </Step>

      <Step title="Clique em Done quando terminar de configurar o prompt." />
    </Steps>
  </Tab>

  <Tab title="Avançado: Segmentação Baseada em Categorias">
    Para mensagens direcionadas baseadas nos interesses do usuário, configure categorias:

    <Steps>
      <Step title="Selecione Categories nas configurações do seu prompt" />

      <Step title="Configure cada categoria com:">
        * **Label**: O que os usuários veem no prompt
        * **Tag Key**: [Chave de tag](./add-user-data-tags) interna para segmentação
      </Step>

      <Step title="Clique em Done quando terminar de configurar o prompt." />
    </Steps>

    <Frame caption="Exemplo: Configurar categorias News e Deals cria tags 'news: 1' e 'deals: 1' para usuários que marcam essas opções">
      <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/39ebfb19de43d53d6f07956c6e96bb101dca53dca81a58f6fc55a021f73ccdc9-Screenshot_2025-02-18_at_3.36.56_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=3d0d41386891b9b84ed2619da519206d" width="1910" height="1604" data-path="images/docs/39ebfb19de43d53d6f07956c6e96bb101dca53dca81a58f6fc55a021f73ccdc9-Screenshot_2025-02-18_at_3.36.56_PM.png" />
    </Frame>

    **Lógica de Tags**: Categorias marcadas definem o valor da tag como `1`, desmarcadas como `0`. Essas tags possibilitam mensagens direcionadas para interesses específicos do usuário.
  </Tab>
</Tabs>

#### Notificação de boas-vindas

Configure uma notificação imediata enviada após os usuários se inscreverem pela primeira vez. Isso:

* Agradece aos usuários pela inscrição
* Demonstra como as notificações aparecem
* Aumenta o engajamento e reduz cancelamentos de inscrição

Configure o texto e o tempo da sua mensagem de boas-vindas, depois role para baixo e clique em **Save**.

<Tip>
  Ignore a seção **Advanced Push Settings** no Painel do OneSignal por enquanto — essas são para [configuração personalizada do Web SDK](./web-sdk-setup). Clique em **Save** para continuar.
</Tip>

### 2. Configure o plugin do WordPress

Após salvar a configuração do painel, você verá seu **App ID** e **API Key**. Copie esses valores para o seu plugin do WordPress:

<Frame caption="Copie seu App ID e API Key do painel do OneSignal">
  <img src="https://mintcdn.com/onesignal/sCO1i1UqrWQxmZ28/images/dashboard/wordpress-app-id-and-api-key.png?fit=max&auto=format&n=sCO1i1UqrWQxmZ28&q=85&s=90643a5aafc920c3785b42a093ae1773" width="1648" height="826" data-path="images/dashboard/wordpress-app-id-and-api-key.png" />
</Frame>

<Info>
  **Não vê uma API Key?** Siga nosso [guia de Keys & IDs](./keys-and-ids) para
  criar uma.
</Info>

<Steps>
  <Step title="No admin do seu WordPress, navegue até as configurações do plugin OneSignal" />

  <Step title="Cole o App ID e REST API Key exatamente como mostrado no seu painel" />
</Steps>

<Frame caption="Certifique-se de que o App ID e REST API Key do seu plugin WordPress correspondem exatamente ao seu painel do OneSignal">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c92c0ca5a7e910104a2c3e5d0fa87e63c2a9adb61aa20de072b41b49006a70c0-Screenshot_2025-02-13_at_3.49.16_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=ba2996eacb58d914c34edc5884e5abb1" width="1828" height="1064" data-path="images/docs/c92c0ca5a7e910104a2c3e5d0fa87e63c2a9adb61aa20de072b41b49006a70c0-Screenshot_2025-02-13_at_3.49.16_PM.png" />
</Frame>

#### Configurações avançadas

Configure opções adicionais do plugin com base nas suas necessidades:

<Frame caption="Configurações avançadas para funcionalidade aprimorada e rastreamento de analytics">
  <img src="https://mintcdn.com/onesignal/bqiNDj5j2mpssdoy/images/push/wordpress-advanced-settings.png?fit=max&auto=format&n=bqiNDj5j2mpssdoy&q=85&s=a6142c3df995140d2927cbc7c6058149" width="1946" height="1410" data-path="images/push/wordpress-advanced-settings.png" />
</Frame>

**Rastreamento de parâmetros de URL**

Adicione parâmetros de analytics às URLs de notificação para rastreamento. **Importante**: Escape caracteres especiais—a entrada é adicionada como está às URLs.

**Exemplo para Google Analytics:**

```
utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin
```

**Exemplo com caracteres especiais:**

```
utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots
```

**Configurações adicionais**

* **Custom Post Types**: Adicione tipos de post de plugins para habilitar opções de notificação
* **Automatically send notifications when a post is published**: Marca automaticamente a caixa de notificação ao publicar posts para que notificações sejam enviadas sem ter que marcar a caixa manualmente
* **Automatically send notifications when a post is updated**: Marca automaticamente a caixa de notificação ao atualizar posts para que notificações sejam enviadas sem ter que marcar a caixa manualmente
* **Automatically send notifications when a page is published**: Marca automaticamente a caixa de notificação ao publicar páginas para que notificações sejam enviadas sem ter que marcar a caixa manualmente
* **Automatically send notifications when a page is updated**: Marca automaticamente a caixa de notificação ao atualizar páginas para que notificações sejam enviadas sem ter que marcar a caixa manualmente
* **Automatically send a push notification when I publish a post from 3rd party plugins**: Envia notificações automaticamente de plugins de publicação externos
* **Mobile App Integration**: Envia notificações para seus assinantes de aplicativo móvel usando o mesmo App ID do OneSignal

### 3. Complete a migração (Somente para Usuários que Estão Atualizando)

<Note>
  **Novas instalações podem pular esta etapa. Se você está atualizando da v2+, siga
  estas instruções...**
</Note>

<Warning>
  **Urgente**: Complete estas etapas o mais rápido possível para evitar que usuários percam
  notificações durante a transição.
</Warning>

<Steps>
  <Step title="Após salvar a configuração do painel do OneSignal, retorne ao WordPress" />

  <Step title="Clique em Migration Completed nas configurações do plugin" />

  <Step title="Clique em Save Settings para finalizar a atualização" />
</Steps>

<Frame caption="Clique em Migration Completed para finalizar a atualização do seu plugin">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ba2d812c5757d50ee60885c45f229e2bba4ff2da42ba3fb0098ac5b5621eba-Screenshot_2024-12-19_at_2.33.31_PM.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=2d55f565db10c116fed39ca3f5930cb4" width="1059" height="312" data-path="images/docs/01ba2d812c5757d50ee60885c45f229e2bba4ff2da42ba3fb0098ac5b5621eba-Screenshot_2024-12-19_at_2.33.31_PM.png" />
</Frame>

<Check>
  Configuração completa! Clique em **Save Settings** para finalizar a configuração do plugin.
</Check>

***

## Testando sua configuração

<Tabs>
  <Tab title="Teste Inicial">
    1. **Visite seu site** (evite navegação anônima/privada—usuários não podem
       se inscrever nesses modos) 2. **Procure pelo slidedown prompt** que você
       configurou

    <Frame caption="Seu slidedown prompt configurado deve aparecer com base nas suas configurações de tempo">
      <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7aca650375517543ad8c80bedc0c75a224a51dd63e84c67798ab4b1812b01498-Screenshot_2025-02-24_at_9.58.05_AM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=d937481d712d3340ba8ef9b25a274901" width="1600" height="700" data-path="images/docs/7aca650375517543ad8c80bedc0c75a224a51dd63e84c67798ab4b1812b01498-Screenshot_2025-02-24_at_9.58.05_AM.png" />
    </Frame>

    3. **Clique no botão de inscrição** (rotulado como "Subscribe" neste exemplo)
    4. **Aceite a permissão do navegador** quando solicitado

    <Frame caption="Prompt de permissão do navegador (aparência varia por navegador) é necessário para notificações push web">
      <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/fac77534f9a5182d0a2351713a23f10f26f779ff5182c0c2c8a1289372dea9a9-Screenshot_2025-02-13_at_4.44.29_PM.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=60785d5a04fe7f2f5450fb05b414d5ee" width="1612" height="490" data-path="images/docs/fac77534f9a5182d0a2351713a23f10f26f779ff5182c0c2c8a1289372dea9a9-Screenshot_2025-02-13_at_4.44.29_PM.png" />
    </Frame>

    5. **Verifique a notificação de boas-vindas** (se configurada)

    <Frame caption="Notificação de boas-vindas aparece imediatamente após inscrição bem-sucedida">
      <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1752c5e7341bbb505d93af428bba12e4042257cb518e281ccb887b1a415dbaee-Screenshot_2025-02-13_at_4.44.40_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=d9575a52cb6bfdb1ae770daf3bb82ed2" width="740" height="198" data-path="images/docs/1752c5e7341bbb505d93af428bba12e4042257cb518e281ccb887b1a415dbaee-Screenshot_2025-02-13_at_4.44.40_PM.png" />
    </Frame>
  </Tab>

  <Tab title="Verificar Inscrição">
    1. No seu painel do OneSignal, vá para **Audience > Subscriptions** 2. Você
       deve ver sua [inscrição](./subscriptions) de push web marcada como
       "Subscribed"

    <Frame caption="Inscrições bem-sucedidas aparecem no painel de audiência do OneSignal">
      <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/cf9b6a27fb8a32c5228e9123646e6ad5ca5b3ceb4d74fd8cf42e016e36f67c5a-Screenshot_2025-02-13_at_4.52.19_PM.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=b8152e5f84b8bcdda32888268bbede00" width="3006" height="788" data-path="images/docs/cf9b6a27fb8a32c5228e9123646e6ad5ca5b3ceb4d74fd8cf42e016e36f67c5a-Screenshot_2025-02-13_at_4.52.19_PM.png" />
    </Frame>
  </Tab>

  <Tab title="Enviar Mensagem de Teste">
    1. Navegue até **Messages > Push** no seu painel do OneSignal 2. Crie uma
       **New Message** 3. Envie uma notificação de teste para você mesmo 4. Verifique se a
       notificação aparece corretamente Consulte nosso [guia de mensagens Push](./push)
       para instruções detalhadas.
  </Tab>
</Tabs>

<Check>
  **Sucesso!** Seu site WordPress agora está configurado para notificações push web.
  Usuários começarão a aparecer em suas Subscriptions conforme se inscrevem.
</Check>

**Próximos Passos:**

* Revise [Prompts de permissão web](./permission-requests) para personalização avançada
* Explore [Configuração de canais](./channel-setup) para integração de email e SMS
* Configure [estratégias de segmentação](./segmentation) para mensagens direcionadas

<Info>
  **Tendo Problemas?** Confira nosso [guia de solução de problemas do WordPress](./troubleshooting-wordpress-web-push) para soluções comuns.
</Info>

***

## Publicando notificações

Quando você agenda um post para ser publicado, o OneSignal também agendará uma notificação push para ser enviada aos seus assinantes no horário agendado. Se você reagendar o post, a notificação push será cancelada e um novo push será agendado para o novo horário.

Você pode visualizar suas notificações agendadas e canceladas no painel do OneSignal em **Delivery > Scheduled Messages**. Consulte [Relatórios de mensagens Push](./push-notification-message-reports) para mais detalhes.

### Notificações básicas de post

Ao criar ou editar um post do WordPress, localize o metabox **OneSignal Push Notifications** (geralmente na parte inferior ou barra lateral do editor de posts).

<Frame caption="Metabox OneSignal Push Notifications—arraste para reposicionar se necessário">
  <img src="https://mintcdn.com/onesignal/kAXbp86YqdTAbPtE/images/web-push/onesignal-push-notifications-metabox-wordpress.png?fit=max&auto=format&n=kAXbp86YqdTAbPtE&q=85&s=428a477e16f85fa50f9ff69678304340" width="3252" height="1674" data-path="images/web-push/onesignal-push-notifications-metabox-wordpress.png" />
</Frame>

**Para enviar uma notificação:**

* Marque **"Send notification when post is published or updated"**
* Desmarque para pular o envio de notificação para esse post

### Segmentação de audiência

#### Enviar para todos os assinantes (padrão)

Por padrão, as notificações vão para todos os [assinantes](./subscriptions) de push.

#### Enviar para segmentos específicos

Direcione audiências específicas usando [segmentos](./segmentation) que você cria em **OneSignal Dashboard > Audience > Segments**.

**Se você configurou categorias no Passo 3**, crie os segmentos correspondentes:

1. Vá para **Audience > Segments** no seu painel do OneSignal
2. Crie segmentos usando suas chaves de tag, por exemplo:
   * **Segmento News**: Tag `news` é `1`
   * **Segmento Deals**: Tag `deals` é `1`

<Frame caption="Tags diferenciam maiúsculas de minúsculas! 'news' e 'News' são tags diferentes">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e7c2b21714e2de8653ac569fc65eb929988f5ccede8429168a40cae0067d893d-Screenshot_2025-02-18_at_4.45.19_PM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=361fb5f307e412e28b1f3da26c4682d3" width="1446" height="926" data-path="images/docs/e7c2b21714e2de8653ac569fc65eb929988f5ccede8429168a40cae0067d893d-Screenshot_2025-02-18_at_4.45.19_PM.png" />
</Frame>

3. Após criar os segmentos, atualize o editor de posts do WordPress
4. Selecione seu segmento alvo no menu suspenso

<Frame caption="Selecione segmentos específicos para direcionar grupos de usuários relevantes">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9cb2736bc8b318d1de60b5b40887db8adda8f7797289bb0ad00d8e98e9e9c902-Screenshot_2025-02-19_at_10.36.16_AM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=551c8c99851ad4fc431abf0e30084aa5" width="2030" height="796" data-path="images/docs/9cb2736bc8b318d1de60b5b40887db8adda8f7797289bb0ad00d8e98e9e9c902-Screenshot_2025-02-19_at_10.36.16_AM.png" />
</Frame>

<Check>
  **Segmentação Avançada**: Crie segmentos baseados em comportamento do usuário, localização,
  tipo de dispositivo e muito mais. [Tags](./add-user-data-tags) fornecem a maior
  flexibilidade para dados personalizados de usuário e personalização.
</Check>

### Personalizando o conteúdo da notificação

#### Comportamento padrão

* **Title**: Usa o título do seu site WordPress (Settings > General)
* **Message**: Usa o título do post
* **Image**: Usa a imagem destacada do post (se definida)
* **URL**: Link para o post publicado

#### Conteúdo personalizado

Marque **"Customize notification content"** para substituir os padrões:

<Frame caption="Personalize título, conteúdo e outros elementos da notificação">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/40837af4e6fefa7d4303f5a3d49992396eb152cec5fd2420d7064aecef32c1af-Screenshot_2025-02-19_at_10.48.18_AM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=8fef18d9723782c41604c358d69723ee" width="2064" height="1114" data-path="images/docs/40837af4e6fefa7d4303f5a3d49992396eb152cec5fd2420d7064aecef32c1af-Screenshot_2025-02-19_at_10.48.18_AM.png" />
</Frame>

**Resultado de exemplo:**

<Frame caption="Notificação push personalizada como aparece para os usuários">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a5011ec82798e7b6b31a9c5e2a26d2fb98a2c17dbc3fb0cb9895453f74d3240a-Screenshot_2025-02-19_at_10.49.26_AM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=f1bbce88aeba84939032658beef5cf4d" width="740" height="198" data-path="images/docs/a5011ec82798e7b6b31a9c5e2a26d2fb98a2c17dbc3fb0cb9895453f74d3240a-Screenshot_2025-02-19_at_10.49.26_AM.png" />
</Frame>

### Adicionar um Custom Post Type ao OneSignal WordPress Plugin

#### Encontre o nome do seu custom post type

Observe a barra de endereços do seu navegador ao criar um novo post. A URL será algo como:

```
https://seusite.com/wp-admin/post-new.php?post_type=seu_tipo_personalizado
```

O valor do parâmetro `post_type` (por exemplo, `seu_tipo_personalizado`) é o nome exato que você precisará adicionar nas configurações do plugin OneSignal.

#### Adicionar às configurações do OneSignal

1. Vá para **OneSignal > Settings** no admin do WordPress
2. Em **Advanced Settings**, adicione os nomes dos seus custom post types no campo **Custom Post Types**
3. Salve as configurações

<Note>
  **Exemplos comuns:** `product` (WooCommerce), `tribe_events` (Events
  Calendar), `portfolio`{" "}
</Note>

## Integração com aplicativo móvel

Se você tem um aplicativo móvel usando o mesmo App ID do OneSignal:

1. Habilite **"Send notification to Mobile app subscribers"** nas configurações do plugin
2. No metabox do post, adicione uma **Mobile URL** para [deep linking](./deep-linking)
3. Usuários móveis serão direcionados para seu app em vez do navegador web

<Check>
  **Pronto para Escalar**: Explore [estratégias avançadas de push](./push) e
  [jornadas automatizadas](./journeys-overview) para campanhas sofisticadas de notificação.
</Check>

<Warning>
  **Notificações Não Aparecem?** Confira nosso [guia de solução de problemas de push web](./notifications-not-shown-web-push) para soluções.
</Warning>

***

## FAQ

<Accordion title="Como desabilito prompts em páginas específicas?" icon="circle-chevron-down">
  **Nota**: Este método funciona apenas com slidedown e prompts de permissão nativos, não com bell ou prompts de link personalizados.

  1. No seu painel do OneSignal, vá para **Settings > Push & In-App > Web Settings**
  2. Selecione seu prompt da tabela **Permission Prompt Setup**
  3. Desmarque **Auto Prompt** e clique em **Done**

  <Frame caption="Desabilite Auto Prompt para controlar manualmente quando os prompts aparecem">
    <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/814f50f2de90ad37c5213f963cd9dca9214b5dcc708650269d139254d55a9985-Screenshot_2025-02-13_at_5.06.27_PM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=bd44f572649f92e94a98dbe772f5973b" width="712" height="840" data-path="images/docs/814f50f2de90ad37c5213f963cd9dca9214b5dcc708650269d139254d55a9985-Screenshot_2025-02-13_at_5.06.27_PM.png" />
  </Frame>

  4. Role para baixo, clique em **Save**, depois em **Finish**
  5. Adicione [código JavaScript personalizado](./web-sdk-reference#slidedown-prompts) em páginas específicas onde você deseja que os prompts apareçam

  Isso lhe dá controle completo sobre o tempo e posicionamento dos prompts. Consulte [Prompts de permissão web](./permission-requests) para detalhes de implementação.
</Accordion>

<Accordion title="Posso enviar notificações para assinantes de aplicativos móveis?" icon="circle-chevron-down">
  Sim! Se seu aplicativo móvel usa o mesmo App ID do OneSignal:

  1. Habilite **"Send notification to Mobile app subscribers"** nas configurações do plugin WordPress
  2. Ao publicar posts, use o campo **Mobile URL** no metabox OneSignal para especificar deep links
  3. Sem uma Mobile URL personalizada, os usuários serão direcionados para o seu site

  Este recurso permite mensagens entre plataformas a partir de uma única interface do WordPress.
</Accordion>

<Accordion title="Como envio email ou SMS pelo WordPress?" icon="circle-chevron-down">
  O plugin WordPress atualmente suporta apenas notificações push. Para email e SMS:

  1. **Email**: Siga nosso [guia de configuração de Email](./email-setup), depois use as [ferramentas de mensagens Email](./email-messaging)
  2. **SMS**: Siga nosso [guia de configuração de SMS](./sms-setup), depois use as [ferramentas de mensagens SMS](./sms-messaging)

  Ambos os canais podem ser gerenciados a partir do mesmo painel do OneSignal junto com suas notificações push.
</Accordion>

<Accordion title="Por que meus prompts não estão funcionando após a migração?" icon="circle-chevron-down">
  **Problemas de Cache**: O cache do WordPress pode atrasar as mudanças da migração.

  **Solução:**

  **Passo 1:** Clique com o botão direito no seu site e selecione **Inspect**

  **Passo 2:** Vá para a aba **Network**

  **Passo 3:** Marque **"Disable cache"**

  <Frame caption="Desabilite o cache do navegador para forçar o carregamento de arquivos atualizados após a migração">
    <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/34b7e61edec0e1fec8954fec630ca0dc60459ad15d9472b5622b5e461b791256-Screenshot_2024-12-20_at_3.02.43_PM_1.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=9d7c9c09a6908cecf53578b1ba882342" width="777" height="156" data-path="images/docs/34b7e61edec0e1fec8954fec630ca0dc60459ad15d9472b5622b5e461b791256-Screenshot_2024-12-20_at_3.02.43_PM_1.png" />
  </Frame>

  **Passo 4:** Atualize seu site para ver a configuração atual

  **Passo 5:** Limpe as configurações do seu plugin de cache do WordPress, se aplicável
</Accordion>

<Accordion title="O que significa o erro `A bad HTTP response code (404)`?" icon="circle-chevron-down">
  Este erro indica migração incompleta:

  <Frame caption="Erro 404 no console do navegador indica processo de migração incompleto">
    <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5cf024c8bd09be6d420f85f846feef7242302c2052046f283ddeed09f73562d1-Screenshot_2024-12-20_at_3.11.58_PM_1.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=5cb3f5dac155fe97a0a1b3051a138242" width="1136" height="252" data-path="images/docs/5cf024c8bd09be6d420f85f846feef7242302c2052046f283ddeed09f73562d1-Screenshot_2024-12-20_at_3.11.58_PM_1.png" />
  </Frame>

  **Solução:**

  1. Certifique-se de que você salvou a configuração do painel do OneSignal
  2. No WordPress, clique em **"Migration Completed"** nas configurações do plugin
  3. Clique em **Save Settings** para finalizar a atualização

  **Este erro afeta apenas usuários que estão atualizando da versão 2.x.x.**
</Accordion>

<Accordion title="Posso modificar os parâmetros da notificação antes de enviar?" icon="circle-chevron-down">
  Sim, você pode usar o filtro `onesignal_send_notification`.

  <Info>
    Coloque código PHP personalizado em `wp-content/mu-plugins/onesignal-custom.php`. Isso
    garante que ele carregue corretamente e evita que seja sobrescrito por atualizações.
  </Info>

  ```php theme={null}
  <?php

  add_filter('onesignal_send_notification', function($fields, $post_id) {

    // Include any properties mentioned in the Create Notification API Reference:
    // https://documentation.onesignal.com/reference/push-notification eg:

    // Add action buttons
    $fields['web_buttons'] = array(
      array(
        "id" => "read-more",
        "text" => "Read More",
        "url" => get_permalink($post->ID)
      )

    // Return the modified fields array
    return $fields;

  }, 10, 2);
  ```
</Accordion>

***