Primeiros passos com o Notti

Instale o SDK do Notti (ou chame a API REST diretamente) e tenha sua primeira notificação entregue. Siga as seções em ordem para a primeira configuração, ou vá direto para a área de que você precisa.

Primeiros passos com o Notti: crie um App, encontre suas chaves e conheça o painel
Instalar o SDK: instale o SDK React Native ou iOS, ou registre dispositivos diretamente via REST
Teste sua integração: verifique a entrega antes de ir para produção
Solução de problemas: diagnostique problemas de entrega

Primeiros passos com o Notti

Crie um App para obter o ID dele e as chaves REST/de cliente, exibidas uma única vez - todas as outras chamadas desta seção dependem deles.

Apps e Empresas - Onboarding, o seletor de Empresa e a lista de Apps no painel.
Membros da equipe - Convide e gerencie quem tem acesso ao painel.
E-mails e recuperação de conta - Quais e-mails o Notti envia, redefinição de senha, verificação de e-mail e limites de requisições de autenticação.
Chaves e IDs - Encontre o ID do seu App e rotacione as chaves REST/de cliente pelo painel.
Mensagens in-app - Crie, segmente, agende e meça mensagens in-app.
Logs de auditoria - Veja quem fez o quê, pelo painel.
Uso e cobrança - Uso de MAU (usuários ativos mensais) e status do plano.
Licença self-hosted - Limites do Free, o plano Ultimate e como comprar e ativar um código de licença.

Instalar o SDK

Configuração do SDK React Native - Instale, inicialize, registre dispositivos e trate eventos de notificação em um app React Native.
Configuração do SDK iOS - Instale o SDK nativo de iOS, inicialize, identifique usuários e trate eventos de notificação, mensagens in-app e mídia rica.
Configuração do SDK Android - Instale o SDK nativo de Android, inicialize, identifique usuários e trate eventos de notificação, mensagens in-app e o seu próprio serviço FCM.

O Notti oferece hoje três SDKs de cliente: React Native, iOS nativo e Android nativo. Todas as outras plataformas (web, jobs de backend) registram e gerenciam dispositivos diretamente na API REST - não é necessário um SDK separado, apenas a Referência da API de Devices e uma chave de cliente.

Teste sua integração

Testando sua integração - Não existe modo sandbox/dry-run - registre um dispositivo de teste real e verifique a entrega antes de ir para produção.

Solução de problemas

Solução de problemas - Leitura de erros de entrega, comportamento de cancelamento automático de inscrição e códigos de falha comuns de APNs/FCM.

Depois da configuração

Usando as APIs REST - URL base, autenticação por grupo de endpoints, limites de requisições e requisições idempotentes.
Referência da API - Método, path, requisito de autenticação, formato da requisição e formato da resposta de cada endpoint.

FAQ

Como identifico a mesma pessoa em vários dispositivos?

Defina o mesmo external_user_id em cada dispositivo que essa pessoa possui (POST/PATCH /v1/apps/{app_id}/devices). Segmente essa pessoa com target_type: "external_user_ids" no envio de uma notificação - o Notti entrega para todos os dispositivos que carregam esse ID. Veja a Referência da API de Devices e de Notifications para os campos exatos.

Preciso de um SDK ou posso chamar a API REST diretamente?

Ambos funcionam. Os SDKs encapsulam o registro de dispositivos e o tratamento de eventos de notificação para React Native, iOS nativo e Android nativo. Qualquer outro cliente (um app web, um job de backend) registra e atualiza dispositivos diretamente com uma chave de cliente - não há diferença funcional no que o Notti faz com o dispositivo depois de registrado.

Como envio notificações do meu servidor?

Use a chave REST (rk_...) do seu App com POST /v1/apps/{app_id}/notifications. Nunca distribua uma chave REST dentro de um cliente mobile ou web - use a chave de cliente (ck_...) nesses casos, restrita ao registro de dispositivos. Veja Usando as APIs REST para o modelo de autenticação completo.

Existe um modo sandbox ou de envio de teste?

Não - todo envio tenta uma entrega real. Veja Testando sua integração para saber como testar com segurança em um dispositivo real, incluindo a configuração da credencial APNs sandbox vs produção no iOS.

Como sei se um push falhou na entrega?

Consulte GET /v1/apps/{app_id}/notifications/{id}/deliveries para ver o status e o last_error por dispositivo, ou registre um webhook para receber os eventos notification.failed / device.invalid em vez de fazer polling. Veja Solução de problemas para entender o que os erros comuns significam.