> ## 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.

# Construindo uma integração com o OneSignal: Guia para parceiros

> Tudo o que você precisa saber sobre construir sua própria integração OneSignal

Integrar sua plataforma com o OneSignal desbloqueia oportunidades poderosas para clientes mútuos, impulsionando maior engajamento e valor do usuário. Este guia descreve os benefícios, opções de integração e etapas para se juntar com sucesso ao nosso ecossistema de parceiros.

## Começando

Para começar a desenvolver sua integração, simplesmente crie uma conta gratuita em onesignal.com. Se você gostaria de participar do nosso programa de parceiros ou requer acesso a recursos premium para desenvolvimento e teste de integração, entre em contato através de [partners.onesignal.com](https://partners.onesignal.com) ou contate-nos por e-mail em `bd@onesignal.com`.

### Benefícios de integrar com o OneSignal

Como parceiro OneSignal, você ganhará benefícios valiosos alinhados com o sucesso e engajamento da sua integração:

* **Visibilidade e reconhecimento:** Mostre sua integração através de uma listagem verificada no Diretório de Parceiros OneSignal, com oportunidades de maior exposição e listagens "em destaque" conforme sua parceria cresce.
* **Colaboração aprimorada:** Participe de atividades conjuntas de co-marketing, iniciativas de co-venda e acesse treinamento abrangente para maximizar a adoção da integração.
* **Suporte estratégico:** Obtenha acesso direto às nossas equipes dedicadas de suporte e técnicas, com níveis adicionais de suporte desbloqueados com base em marcos de parceria.
* **Oportunidades de crescimento:** Acesse benefícios de parceiros progressivamente avançados, como páginas de documentação dedicadas, contas sandbox empresariais e oportunidades de marketing priorizadas conforme você expande sua base de clientes e atinge marcos de parceria específicos.

### Requirement: `OneSignal-Usage` Header

Para participar do programa de parceiros, você deve incluir o cabeçalho `OneSignal-Usage` em todas as solicitações da API. Este cabeçalho permite que o OneSignal identifique sua integração, forneça melhor suporte e rastreie a adoção entre clientes mútuos.

**Formato:**

```
OneSignal-Usage: <YourCompany> | Partner Integration
```

Substitua `<YourCompany>` pelo nome da sua empresa ou plataforma. Por exemplo, se sua empresa é Acme, use `Acme | Partner Integration`.

<Note>
  **Erro comum:** Usar apenas o nome da sua empresa (por exemplo, `Acme`) sem o sufixo ` | Partner Integration`. O formato completo com o sufixo e espaçamento exato é necessário.
</Note>

***

## Casos de uso comuns de integração

Aqui estão as principais maneiras de integrar com o OneSignal, cada uma oferecendo oportunidades únicas para melhorar a experiência do cliente e impulsionar o crescimento mútuo:

### 1. Acionar notificações (Push, Email, SMS)

Permita que os clientes gerenciem notificações perfeitamente diretamente de sua plataforma, aprimorando o engajamento do cliente em vários canais.

[Documentação de integração Push, Email, SMS](/reference/create-message)

### 2. Gerenciamento de templates de email

Facilite o marketing por email simplificado sincronizando e gerenciando templates de email dentro do OneSignal.

[Documentação da API de template de email](/reference/create-template)

### 3. Criação e gerenciamento de usuários

Automatize a integração de usuários criando e gerenciando usuários e dispositivos diretamente no OneSignal, simplificando o gerenciamento de usuários. É importante entender como um Usuário é definido dentro do OneSignal e a relação um-para-muitos que um Usuário tem com dispositivos (definidos como "assinaturas"). [Veja nosso Guia para entender usuários no OneSignal](./users).\\

[Documentação de criação de usuário](/reference/create-user)

[Documentação de criação de alias](/reference/create-alias)

### 4. Sincronizar atributos de usuário

Habilite mensagens direcionadas sincronizando dados valiosos de usuário (localização, preferências, comportamento) diretamente com o OneSignal.

[Documentação de atualização de atributos de usuário](/reference/update-user)

### 5. Capturar Event Streams

Capture dados valiosos de engajamento de usuário em tempo real (notificações, interações, aberturas de email) para análises aprimoradas e insights acionáveis.

[Documentação de Event Stream](./event-streams)

### 6. Enviar eventos personalizados

Os eventos personalizados permitem que você envie ações importantes do usuário para o OneSignal para serem usadas em gatilhos de Journeys em tempo real, atrasos, segmentação e personalização.

[Documentação de eventos personalizados](./custom-events)

### 7. Incorporação de plataforma

Ofereça integração perfeita aos seus clientes incorporando o OneSignal diretamente em sua plataforma, simplificando a integração de clientes com IDs de aplicativo únicos.

[Documentação de incorporação de plataforma](./developers)

***

## Verificar sua integração

Assim que sua integração estiver pronta, envie os seguintes detalhes para `integrations@onesignal.com`:

* Credenciais de conta sandbox para teste
* Breve visão geral dos casos de uso de integração
* Explicação da sua abordagem usando APIs do OneSignal

A verificação reconhece formalmente sua integração no lado do OneSignal, permitindo acesso total a todas as vantagens do nosso Programa de Parceiros de Integração.

Estamos empolgados em colaborar e ajudar sua integração a ter sucesso!

***