Canais da Caixa Postal

Os canais são os caminhos por onde os arquivos entram na Caixa de Entrada e saem da Caixa de Saída de uma caixa postal. Cada caixa pode ter um canal de cada tipo: AWS S3, SFTP, E-mail, WhatsApp e Syncthing. A API está sempre disponível, sem precisar de ativação.

Onde fica no painel

Na tela da caixa postal, o bloco Canais Disponíveis mostra um cartão por canal. Um canal só pode ser ativado com a caixa postal Ativada; antes disso, o cartão mostra "Só é possível ativar este canal com a caixa postal ativa."

Status do canal

Status	Significado
Pendente	O canal está sendo ativado, desativado ou está trocando a senha.
Ativo	O canal recebe e entrega arquivos.
Inativo	O canal foi desativado.

Pendente -> Ativo -> Pendente -> Inativo -> Pendente -> Ativo

Ações comuns no menu do cartão (ícone de três pontos):

• Desativar Canal: pede confirmação. O canal passa por Pendente e fica Inativo.
• Ativar Canal: em um canal inativo, pede confirmação e reativa.
• Excluir Canal: só em canal Inativo. Um canal ativo precisa ser desativado antes ("O canal precisa ser desativado antes de ser excluído.").

Entrega da Caixa de Saída

Quando um arquivo vai para a Caixa de Saída, a Kobana o entrega pelos canais ativos da caixa:

Canal	Entrega
AWS S3, SFTP e Syncthing	O arquivo fica na pasta de saída da caixa.
E-mail	Mensagem com o arquivo para cada endereço em E-mails que receberão a saída.
WhatsApp	Mensagem com o arquivo para cada número em Números que receberão a saída.

AWS S3

Permite enviar e receber arquivos por um bucket da AWS S3 mantido pela Kobana.

Para ativar, clique em Ativar no cartão e confirme em Ativar. Não há campos a preencher.

Com o canal ativo, Visualizar Dados de Acesso abre Configurações do S3 com:

Dado	Uso
Identity Poll ID, User Poll ID, Client ID	Configuração do diretório de usuários para autenticar o seu cliente S3.
Usuário e Senha	Credenciais da caixa postal.
Região e Bucket	Onde ficam os arquivos.
Caixa de Entrada	Caminho onde você coloca os arquivos para a Kobana.
Caixa de Saída	Caminho onde a Kobana deixa os arquivos para você.

Outras ações:

• Atualizar Arquivos: faz a Kobana procurar arquivos novos na Caixa de Entrada. O painel mostra "Atualização de arquivos iniciada. Os arquivos serão processados em breve."
• Atualizar Senha: pede confirmação e gera uma nova senha.

aviso

A senha completa aparece só logo depois da ativação do canal ou da troca de senha. O painel avisa: "A senha do usuário é exibida apenas uma vez. Guarde-a com segurança." Depois disso ela aparece mascarada.

Os canais S3 e SFTP usam o mesmo usuário e a mesma senha da caixa postal. Atualizar Senha em qualquer um deles troca a senha dos dois.

SFTP

Permite enviar e receber arquivos por um servidor SFTP mantido pela Kobana.

Campo	Obrigatório	Descrição
Chave SSH (opcional)	Não	Sua chave SSH pública, para autenticar sem senha. Em branco, o acesso é por senha.

Com o canal ativo, Visualizar Dados de Acesso mostra Host, Porta, Caixa de Entrada, Caixa de Saída, Usuário, Senha e a Chave SSH cadastrada. O menu também tem Configurações do Canal (trocar a chave SSH), Atualizar Arquivos e Atualizar Senha, que funcionam como no S3.

Em ambientes onde o SFTP não está disponível, o cartão mostra "Este canal está indisponível neste ambiente. Se você deseja testá-lo, contate o suporte."

E-mail

Permite enviar arquivos anexados a um e-mail e receber os arquivos de saída por e-mail.

Campo	Obrigatório	Descrição
E-mails permitidos para entrada	Não	Endereços que podem enviar anexos para a caixa. Sem nenhum endereço, qualquer pessoa pode enviar arquivos.
E-mails que receberão a saída	Não	Endereços que recebem os arquivos da Caixa de Saída. Sem nenhum endereço, a saída não é enviada por e-mail.

Com o canal ativo, o cartão mostra o endereço de e-mail da caixa postal. Envie a mensagem para esse endereço com os arquivos anexados: cada anexo pode ter até 10MB e a soma dos anexos, até 100MB. Cada anexo vira um arquivo na Caixa de Entrada.

Para alterar as listas, use Configurações do Canal.

WhatsApp

Permite enviar arquivos por WhatsApp e receber os arquivos de saída no WhatsApp.

Campo	Obrigatório	Descrição
Números permitidos para entrada	Não	Números que podem enviar arquivos para a caixa. Sem nenhum número, qualquer pessoa pode enviar.
Números que receberão a saída	Não	Números que recebem os arquivos da Caixa de Saída. Sem nenhum número, a saída não é enviada pelo WhatsApp.

Com o canal ativo, o cartão mostra o número de WhatsApp da Kobana. Clique nele para abrir o WhatsApp Web com o token de ativação da caixa e envie a mensagem. Depois, envie os arquivos para esse número; cada arquivo pode ter até 10MB.

Syncthing

Permite sincronizar as pastas de entrada e saída com um servidor seu que rode o Syncthing, um sincronizador de pastas.

Campo	Obrigatório	Descrição
Identificação do Dispositivo	Sim	Nome do seu servidor, por exemplo "Servidor Principal".
Device ID	Sim	O ID do dispositivo no Syncthing, no formato XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX. Só pode ser alterado com o canal inativo ou com erro.

Ao ativar, a Kobana envia ao seu dispositivo os convites de compartilhamento das pastas. O cartão mostra Identificação, Device ID e o status da conexão (Conectado, Desconectado ou Não disponível), com o tempo desde a última atualização. Se a ativação falhar, o cartão mostra "Erro ao ativar o canal" com o motivo.

Ações do menu:

• Visualizar Status: abre Status do Syncthing, com dados do dispositivo (status, visto por último em, endereço, versão do cliente, dados recebidos e enviados) e de cada pasta (Caixa de Entrada e Caixa de Saída: estado, arquivos e bytes, se está sincronizada, erros).
• Atualizar Status: consulta de novo o servidor.
• Reenviar Convites: envia de novo os convites das pastas.
• Configurações do Canal: altera a identificação do dispositivo.

O link Fazer download do Manual traz o passo a passo de instalação.

Permissões

Configurar, ativar, desativar e excluir canais exige a permissão Caixa Postal → Caixas Postais, ação Alterar.

Eventos de webhook

Os canais geram eventos de cadastro no formato mailbox.channel.canal.db.created, .db.updated e .db.deleted, por exemplo mailbox.channel.email.db.created e mailbox.channel.s3.db.updated. Atualizar Arquivos gera mailbox.channel.s3.fetch_all ou mailbox.channel.sftp.fetch_all.

Pela API

Os canais podem ser configurados, ativados e desativados pela API v2.