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. |
| Mensagem com o arquivo para cada endereço em E-mails que receberão a saída. | |
| 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.
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.