Configuração de Credenciais

Obtenção de Credenciais

Para usar o Iara Syncfusion Adapter, você precisa de credenciais válidas da Iara Health:

API Token: Token de autenticação (ex: 197765800edb8affcb44a7ae7b4ff0a3)
User ID: Email ou identificador do usuário (ex: meu@email.com)
Região: south-america ou europe (opcional, padrão: south-america)

Como Obter

Acesse o Portal Iara Health
Faça login ou crie uma conta gratuita
Navegue até Configurações → API Keys
Copie seu API Token e User ID

Configuração do IaraSpeechRecognition

O primeiro passo é configurar o reconhecedor de voz com suas credenciais:

// 1. Instanciar o reconhecedor
const recognition = new IaraSpeechRecognition();

// 2. Configurar credenciais e inicializar
recognition.init({
  userId: 'meu@email.com',
  apiToken: '197765800edb8affcb44a7ae7b4ff0a3',
  region: 'south-america',  // 'south-america' ou 'europe'
  lang: 'pt-BR',
  interimResults: true,
  useVAD: true,
  engine: 'Iara Desktop'
}).done(function() {
  console.log('✅ Recognition inicializado com sucesso');
  // Aqui o recognition está pronto para uso
}).fail(function(error) {
  console.error('❌ Erro na inicialização:', error);
});

Opções de Configuração

Opções Básicas

Opção	Tipo	Padrão	Descrição
`userId`	string	obrigatório	Email ou ID do usuário
`apiToken`	string	obrigatório	Token de autenticação da API
`region`	string	`'south-america'`	Região do servidor (`'south-america'` ou `'europe'`)
`lang`	string	`'pt-BR'`	Idioma do reconhecimento

Opções Avançadas

Opção	Tipo	Padrão	Descrição
`interimResults`	boolean	`true`	Mostrar resultados intermediários durante o ditado
`useVAD`	boolean	`true`	Usar detecção de atividade de voz (Voice Activity Detection)
`engine`	string	`'ALS'`	Engine de reconhecimento a ser usado
`forceConnection`	boolean	`false`	Forçar conexão mesmo se já conectado

Configuração por Ambiente

É uma boa prática usar diferentes credenciais para desenvolvimento e produção:

Usando Variáveis de Ambiente

IARA_USER_ID=dev@exemplo.com
IARA_API_TOKEN=dev-token-aqui
IARA_REGION=south-america

// .env.production
IARA_USER_ID=prod@exemplo.com
IARA_API_TOKEN=prod-token-aqui
IARA_REGION=south-america

// Seu código
recognition.init({
  userId: process.env.IARA_USER_ID,
  apiToken: process.env.IARA_API_TOKEN,
  engine: 'Iara Desktop',
  region: process.env.IARA_REGION,
  lang: 'pt-BR'
});

Exemplo com React

export const iaraConfig = {
  userId: process.env.REACT_APP_IARA_USER_ID,
  apiToken: process.env.REACT_APP_IARA_API_TOKEN,
  engine: 'Iara Desktop',
  region: process.env.REACT_APP_IARA_REGION || 'south-america',
  lang: 'pt-BR'
};

// Componente
import { iaraConfig } from './config/iara';

recognition.init(iaraConfig).done(() => {
  // Pronto para usar
});

Segurança

Boas Práticas

Use .gitignore: Adicione arquivos de ambiente ao .gitignore
```
.env
.env.local
.env.*.local
```
Rotação de Tokens: Rotacione seus tokens periodicamente
Permissões Mínimas: Use tokens com permissões mínimas necessárias
Monitoramento: Monitore o uso de suas credenciais no portal

Verificação da Configuração

Após configurar suas credenciais, você pode verificar se estão funcionando:

recognition.init({
  userId: 'seu@email.com',
  apiToken: 'seu-token'
}).done(function() {
  console.log('✅ Credenciais válidas!');
  console.log('Usuário:', recognition.getUserId());
  console.log('Região:', recognition.getRegion());
}).fail(function(error) {
  console.error('❌ Erro:', error.message);
  // Possíveis erros:
  // - Credenciais inválidas
  // - Sem conexão com internet
  // - Região incorreta
});

Próximos Passos

Agora que você configurou suas credenciais, está pronto para:

Problemas com Credenciais?

Se você está tendo problemas com suas credenciais, consulte: