O SDK básico de chat não solicita permissões. Os hosts que usam APNs, FCM ou voz em conversas nativas habilitam as permissões correspondentes de forma explícita.
Escolher uma capacidade explicitamente
O chat e o widget nativo são as capacidades base. O Mobile SDK 0.4.0 adiciona voz de conversa opcional para chamadas WebRTC diretas com um agente e transferências da IA para um agente. No iOS, o host liga o produto separado `DobroDeskVoiceConversation`. No Android, adiciona `com.dobrodesk:dobrodesk-voice:0.4.0` a partir do repositório Maven local do bundle. O percurso existente de voz apenas para IA, `DobroDeskVoice`, continua separado. Os quatro wrappers de framework oferecem `client.attachNativeConversationVoice()` depois de o host instalar a fábrica nativa opcional. Hosts personalizados ou headless podem fornecer `DobroDeskVoiceConversationPort` através de `attachConversationVoice(port)`.
Mantenha voz e push opcionais. O host declara a permissão de microfone, fornece o solicitador de permissão em tempo de execução do Android e instala a fábrica nativa de voz. O SDK só pede acesso ao microfone depois de o cliente escolher uma ação de voz. As chamadas terminam quando o widget fica oculto ou a app sai do primeiro plano. O consentimento para utilização de IA e o consentimento para gravação de chamadas são distintos. O SDK para visitantes não faz chamadas PSTN, não inclui CallKit e não oferece chamadas em segundo plano.
// Register the extracted bundle's native/maven directory in host settings first.
dependencies {
implementation("com.dobrodesk:dobrodesk-voice:0.4.0") // optional
// implementation("com.dobrodesk:dobrodesk-push:0.4.0") // optional
}Escolha quem entrega as notificações push
Em Configurações > Canais > Push móvel, escolha o modo desativado quando o aplicativo não precisar de notificações de suporte. Escolha entrega externa se seu backend já envia push ou entrega gerenciada se o DobroDesk deve enviá-las por APNs ou FCM. Apenas a entrega gerenciada exige credenciais do provedor no DobroDesk. Trocar o modo preserva as credenciais salvas e não concede permissão no dispositivo. O modo desativado interrompe a entrega pelo DobroDesk. Seu backend controla as notificações que envia e a opção de desativá-las. As assinaturas webhook existentes continuam ativas.
Para entrega pelo aplicativo, registre os tokens no seu backend autenticado e assine o webhook message.created. Verifique a assinatura e workspaceId. Aceite apenas respostas públicas de saída usando data.direction, data.visibility e data.authorKind e elimine duplicatas pelo campo id do evento.
O evento contém data.conversationId, data.messageId e data.customerId. Ele não inclui ID da integração, escopo da conta, ID da sessão ou texto da mensagem. Determine conta, integração, sessão e conversa pelo seu próprio vínculo de registro autenticado antes de escolher um token. A correspondência apenas do cliente em todo o espaço de trabalho é insuficiente. Envie uma notificação genérica sem texto da resposta.
Use o hook publicado de eventos tipados do cliente (`client.events` no Flutter ou `client.subscribe(...)` nos wrappers JavaScript) enquanto o aplicativo e o cliente nativo estiverem ativos. Trate `snapshot` na sua própria interface de conversa no aplicativo.
O hook emite `snapshot` depois que o cliente inicia ou retoma uma sessão ou depois de chamar explicitamente `client.refresh()` ou `client.waitForAssistant()`. O aplicativo host trata qualquer callback de APNs ou FCM do DobroDesk e decide se chama `client.refresh()` ou atualiza sua própria interface. Use o webhook assinado `message.created` para a entrega em segundo plano do seu aplicativo.
Esse é um sinal para atualizar a interface ativa, não um watcher realtime contínuo nem um evento de não lidos. Ele não agenda notificações locais nem solicita permissão para notificações.
Um callback no aplicativo não recebe uma resposta futura depois que o aplicativo para. Deixe o backend entregar a notificação por APNs ou FCM. Não mantenha consultas em segundo plano.
O SDK móvel oferece uma facade push opcional. Conecte o PushPort da plataforma com `client.attachPush(...)` e forneça o adaptador de registro opcional quando o DobroDesk gerenciar o registro. Defina o contexto autenticado antes de `requestPermissionAndRegister()`. A facade valida o escopo do payload recebido e emite somente eventos `payload` correspondentes. Em um `payload` com escopo validado, o host pode chamar `client.refresh()` e usar o `snapshot` resultante na interface ativa. Ela não adiciona Firebase, não agenda notificações locais nem executa novas tentativas em segundo plano. A permissão nativa, os hooks de acesso ao token do dispositivo e a abertura de notificações continuam sob responsabilidade do aplicativo host. A entrega segue o modo selecionado Desativado, Aplicativo ou Gerenciado.
Manter registo push fora do SDK base
Registe o device token pelo fluxo autenticado e associe-o à conta ou sessão DobroDesk verificada. Rode tokens, remova-os no logout e descarte tokens inválidos no servidor. Use apenas identificadores documentados no payload. Não inclua respostas, mensagens ou credenciais.
O cliente base não importa Firebase nem cria registos APNs/FCM. Hosts sem push não devem pedir permissão nem incluir o artefacto.
Manter explícitos a permissão voice e a limpeza
Instale a fábrica nativa opcional durante a configuração do aplicativo host. No iOS, use `DobroDeskOptionalVoiceWidget.install(realtimeOrigin:)` depois de ativar `DobroDeskVoiceConversation`. No Android, use `installOptionalVoiceFactory(webSocketOrigin:permissionRequester:)`. O host iOS adiciona `NSMicrophoneUsageDescription`. O host Android declara `android.permission.RECORD_AUDIO` e fornece uma solicitação de permissão associada à Activity.
O widget pede permissão de microfone apenas depois de o cliente escolher uma ação de voz de IA ou com um agente. A sessão assinada determina as ações disponíveis. As chamadas com um agente podem continuar disponíveis quando a voz de IA está desligada. Se a política de gravação guardada pedir uma escolha, obtenha o consentimento do cliente antes de iniciar a chamada. O widget termina a chamada quando fica oculto ou a app passa para segundo plano. Não são incluídas chamadas em segundo plano.
Elimine a facade de voz no logout ou na substituição do wrapper. Cancele as subscrições de eventos de conversa e ignore callbacks tardios após close, reset ou mudança de conta. Se a capacidade nativa estiver indisponível ou a permissão for recusada, explique o estado e mantenha o chat disponível.
Associar voice apenas depois da configuração nativa
Depois de o host instalar a fábrica nativa opcional, chame `attachNativeConversationVoice()` no cliente Flutter, React Native, NativeScript ou Capacitor. O método devolve a facade nativa de voz de conversa para chamadas diretas com um agente e transferências da IA para um agente. Hosts personalizados ou headless podem fornecer `DobroDeskVoiceConversationPort` através de `attachConversationVoice(port)`. Mantenha `attachVoice(port)` para a capacidade de voz existente, apenas para IA.
A facade de conversa expõe `startHumanCall(options)`, `requestHumanHandoff(options)`, métodos de cancelamento e nova tentativa, `endHumanCall()`, histórico paginado de chamadas e leitura de transcrições. Quando a política guardada exigir uma escolha, `DobroDeskHumanVoiceOptions.recordingConsent` deve refletir a decisão explícita do cliente. O widget nativo recolhe essa decisão através dos controlos de voz integrados.
const voice = await client.attachNativeConversationVoice();
const unsubscribe = voice.subscribeConversation(onConversationVoiceEvent);
// On logout or host teardown:
unsubscribe();
await voice.dispose();