# Horas de silêncio
As horas de silêncio impedem que mensagens de marketing cheguem aos usuários em horários inconvenientes, como tarde da noite. Defina um período de silêncio uma vez para cada canal, e ele se aplica a toda campanha única, envio por API, feed RSS e campanha de geozona do projeto.
O Pushwoosh verifica o período no fuso horário de cada destinatário. Depois, retém a mensagem até o fim do período ou não a envia.
## Configurar as horas de silêncio
1. Acesse **Settings > Message delivery settings > Silent hours**.
2. Em **Time zone for recipients without a device time zone**, selecione o fuso horário a ser usado para destinatários cujo fuso horário é desconhecido. Consulte [Qual fuso horário é usado para cada destinatário](#which-time-zone-is-used-for-each-recipient).
3. Ative a chave de cada canal que você deseja silenciar: **Push notifications**, **In-apps** (mensagens in-app enviadas pela API), **Emails**, **SMS**, **WhatsApp**, **LINE**, **Kakao** ou **Telegram**.
4. Em **Pause sending**, defina o início e o fim do período de silêncio, por exemplo 10:00 PM – 08:00 AM.
O período pode passar da meia-noite. Um canal ativado pela primeira vez começa com 22:00 – 08:00.
5. Em **Message behavior**, escolha o que acontece com uma mensagem que cai no período de silêncio: **Send after the silence period ends** (padrão) ou **Do not send**. Consulte [O que acontece com uma mensagem durante as horas de silêncio](#what-happens-to-a-message-during-silent-hours).
6. Em **Silence period schedule**, selecione **Pause for entire day** para cada dia da semana em que o canal não deve enviar nenhuma mensagem de marketing, por exemplo domingo. Nesse dia, o canal fica em silêncio das 00:00 às 23:59.
7. Clique em **Apply changes**.
### Qual fuso horário é usado para cada destinatário
O Pushwoosh verifica as horas de silêncio pelo horário local de cada destinatário:
* **Assinantes de push de aplicativo e web** (iOS, Android, Huawei, Amazon, macOS, Windows e navegadores web): o fuso horário que o SDK do Pushwoosh informa a partir do dispositivo.
* **Destinatários de e-mail, SMS e mensageiros que também têm assinatura do seu aplicativo ou site** com o mesmo User ID: o fuso horário desse dispositivo do aplicativo. Se o usuário tiver vários, é usado o mais a leste.
* **Todos os demais**, como contatos de e-mail e SMS sem o aplicativo instalado: o fuso horário selecionado em **Time zone for recipients without a device time zone**. Se você não selecionar nenhum, o Pushwoosh usa UTC.
## O que acontece com uma mensagem durante as horas de silêncio
O resultado depende do **Message behavior** escolhido para o canal:
* **Send after the silence period ends** (padrão): a mensagem é retida e enviada assim que o período termina.
Se o dia estiver configurado com **Pause for entire day**, a mensagem aguarda o próximo dia sem pausa. Com um período noturno como 22:00–08:00, ela sai às 08:00 desse dia. Com um período diurno como 10:00–12:00, ela sai às 00:00.
* **Do not send**: os destinatários que estão dentro do período de silêncio não recebem a mensagem. Para ver quantos foram ignorados, confira as [estatísticas de horas de silêncio](#view-silent-hours-statistics).
Se você selecionar **Pause for entire day** para os sete dias, o Pushwoosh ignora essas caixas de seleção e usa apenas o período de **Pause sending**.
## Horas de silêncio em campanhas únicas
Uma campanha única segue as horas de silêncio globais do canal definidas em **Settings > Message delivery settings**. Para verificar ou alterar isso em uma campanha:
1. Na etapa **Sending time**, encontre o bloco **Silent hours** em **Sending options**.
2. Para seguir as horas de silêncio globais, mantenha **Use global silent hours settings**. Essa é a opção padrão.
3. Para enviar a campanha mesmo durante o período de silêncio, por exemplo um aviso de serviço urgente, selecione **Send messages without global silent hours**.
Escolha a opção antes de agendar a campanha. Ao editar uma campanha agendada, a opção **Silent hours** não pode ser alterada.
Para alterar as configurações globais, clique em **Set up** no bloco. Message delivery settings abre em uma nova aba.
### Quando as horas de silêncio não se aplicam a uma campanha
Uma campanha é enviada sem horas de silêncio nestes casos:
* **As horas de silêncio não estão configuradas para o canal.**
* **O tipo de mensagem é Transactional.** Mensagens transacionais nunca são retidas pelas horas de silêncio, por isso a campanha não tem o bloco **Silent hours**. Consulte [Mensagens de marketing vs. transacionais](/pt/product/messaging-channels/marketing-vs-transactional/).
* **A campanha vai para um segmento High Speed Delivery.** A mensagem é enviada imediatamente, e o bloco **Silent hours** informa isso.
## Horas de silêncio na API
Mensagens enviadas pela API também seguem as horas de silêncio. Para enviar uma mensagem sem elas, defina o campo `silent_hours` na [Messaging API v2](/pt/developer/api-reference/messaging-api-v2/notify/#silenthours).
## Mensagens que ignoram as horas de silêncio
As horas de silêncio não se aplicam a:
* **Mensagens de Customer Journey.** Os journeys usam seu próprio [Período de silêncio](/pt/product/customer-journey/journey-settings/#silence-period), definido nas configurações do journey.
* **Mensagens transacionais**, enviadas pelo Control Panel ou pela API.
* **Mensagens do Viber**, pois o Viber não tem configuração de horas de silêncio.
* **In-apps instantâneos** criados no Control Panel. O aplicativo os exibe no momento em que o evento de gatilho acontece.
* **Notificações push silenciosas** e atualizações de **Live Activity**.
* **Mensagens para segmentos High Speed Delivery.**
## Ver as estatísticas de horas de silêncio
Para ver quantos destinatários foram ignorados por **Do not send**, confira as estatísticas da mensagem:
* Aba **Overview**: **Excluded: silent hours** na etapa Audience.
* Aba [Errors](/pt/product/statistics-and-analytics/messaging-statistics/how-to-read-the-errors-tab/): a linha **Silent Hours (1041)**. Não é uma falha de entrega: ela conta os destinatários ignorados por **Do not send**.
Mensagens retidas por **Send after the silence period ends** não são relatadas separadamente. Elas são contadas como enviadas quando saem após o período de silêncio.
3. Ative a chave de cada canal que você deseja silenciar: **Push notifications**, **In-apps** (mensagens in-app enviadas pela API), **Emails**, **SMS**, **WhatsApp**, **LINE**, **Kakao** ou **Telegram**.
4. Em **Pause sending**, defina o início e o fim do período de silêncio, por exemplo 10:00 PM – 08:00 AM.
O período pode passar da meia-noite. Um canal ativado pela primeira vez começa com 22:00 – 08:00.
5. Em **Message behavior**, escolha o que acontece com uma mensagem que cai no período de silêncio: **Send after the silence period ends** (padrão) ou **Do not send**. Consulte [O que acontece com uma mensagem durante as horas de silêncio](#what-happens-to-a-message-during-silent-hours).
6. Em **Silence period schedule**, selecione **Pause for entire day** para cada dia da semana em que o canal não deve enviar nenhuma mensagem de marketing, por exemplo domingo. Nesse dia, o canal fica em silêncio das 00:00 às 23:59.
7. Clique em **Apply changes**.
### Qual fuso horário é usado para cada destinatário
O Pushwoosh verifica as horas de silêncio pelo horário local de cada destinatário:
* **Assinantes de push de aplicativo e web** (iOS, Android, Huawei, Amazon, macOS, Windows e navegadores web): o fuso horário que o SDK do Pushwoosh informa a partir do dispositivo.
* **Destinatários de e-mail, SMS e mensageiros que também têm assinatura do seu aplicativo ou site** com o mesmo User ID: o fuso horário desse dispositivo do aplicativo. Se o usuário tiver vários, é usado o mais a leste.
* **Todos os demais**, como contatos de e-mail e SMS sem o aplicativo instalado: o fuso horário selecionado em **Time zone for recipients without a device time zone**. Se você não selecionar nenhum, o Pushwoosh usa UTC.
## O que acontece com uma mensagem durante as horas de silêncio
O resultado depende do **Message behavior** escolhido para o canal:
* **Send after the silence period ends** (padrão): a mensagem é retida e enviada assim que o período termina.
Se o dia estiver configurado com **Pause for entire day**, a mensagem aguarda o próximo dia sem pausa. Com um período noturno como 22:00–08:00, ela sai às 08:00 desse dia. Com um período diurno como 10:00–12:00, ela sai às 00:00.
* **Do not send**: os destinatários que estão dentro do período de silêncio não recebem a mensagem. Para ver quantos foram ignorados, confira as [estatísticas de horas de silêncio](#view-silent-hours-statistics).
Se você selecionar **Pause for entire day** para os sete dias, o Pushwoosh ignora essas caixas de seleção e usa apenas o período de **Pause sending**.
## Horas de silêncio em campanhas únicas
Uma campanha única segue as horas de silêncio globais do canal definidas em **Settings > Message delivery settings**. Para verificar ou alterar isso em uma campanha:
1. Na etapa **Sending time**, encontre o bloco **Silent hours** em **Sending options**.
2. Para seguir as horas de silêncio globais, mantenha **Use global silent hours settings**. Essa é a opção padrão.
3. Para enviar a campanha mesmo durante o período de silêncio, por exemplo um aviso de serviço urgente, selecione **Send messages without global silent hours**.
Escolha a opção antes de agendar a campanha. Ao editar uma campanha agendada, a opção **Silent hours** não pode ser alterada.
Para alterar as configurações globais, clique em **Set up** no bloco. Message delivery settings abre em uma nova aba.
### Quando as horas de silêncio não se aplicam a uma campanha
Uma campanha é enviada sem horas de silêncio nestes casos:
* **As horas de silêncio não estão configuradas para o canal.**
* **O tipo de mensagem é Transactional.** Mensagens transacionais nunca são retidas pelas horas de silêncio, por isso a campanha não tem o bloco **Silent hours**. Consulte [Mensagens de marketing vs. transacionais](/pt/product/messaging-channels/marketing-vs-transactional/).
* **A campanha vai para um segmento High Speed Delivery.** A mensagem é enviada imediatamente, e o bloco **Silent hours** informa isso.
## Horas de silêncio na API
Mensagens enviadas pela API também seguem as horas de silêncio. Para enviar uma mensagem sem elas, defina o campo `silent_hours` na [Messaging API v2](/pt/developer/api-reference/messaging-api-v2/notify/#silenthours).
## Mensagens que ignoram as horas de silêncio
As horas de silêncio não se aplicam a:
* **Mensagens de Customer Journey.** Os journeys usam seu próprio [Período de silêncio](/pt/product/customer-journey/journey-settings/#silence-period), definido nas configurações do journey.
* **Mensagens transacionais**, enviadas pelo Control Panel ou pela API.
* **Mensagens do Viber**, pois o Viber não tem configuração de horas de silêncio.
* **In-apps instantâneos** criados no Control Panel. O aplicativo os exibe no momento em que o evento de gatilho acontece.
* **Notificações push silenciosas** e atualizações de **Live Activity**.
* **Mensagens para segmentos High Speed Delivery.**
## Ver as estatísticas de horas de silêncio
Para ver quantos destinatários foram ignorados por **Do not send**, confira as estatísticas da mensagem:
* Aba **Overview**: **Excluded: silent hours** na etapa Audience.
* Aba [Errors](/pt/product/statistics-and-analytics/messaging-statistics/how-to-read-the-errors-tab/): a linha **Silent Hours (1041)**. Não é uma falha de entrega: ela conta os destinatários ignorados por **Do not send**.
Mensagens retidas por **Send after the silence period ends** não são relatadas separadamente. Elas são contadas como enviadas quando saem após o período de silêncio.