E-mail da empresa

email_send recebe to, de 1 a 20 endereços, subject, body em Markdown e fileIds opcional, uma lista de objetos com fileId e version opcional. Sem versão, usa a edição atual. O remetente aparece como “Ana via Siglata” em mail.siglata.com; as respostas vão para o e-mail de Ana. Não há etapa de aprovação. O resultado inclui sendId e o estado de cada destinatário. subject aceita até 200 caracteres e body até 200.000. Repetir a mesma chamada cria um novo envio; confira os estados antes de tentar novamente. As recusas guardam assunto e motivo, sem o corpo.

Após a aceitação pelo provedor, uma falha ao gravar o resultado não faz email_send falhar: ele retorna os destinatários aceitos com providerMessageId e registra SettlementFailed na atividade. Não repita o envio por esse motivo. Eventos de entrega ou rejeição conciliam envios pendentes quando o ID do provedor corresponde. A rotina de cinco minutos marca envios em andamento há mais de 15 minutos como failed, com motivo outcome_unknown, sem devolver a cota diária: o e-mail pode ter sido aceito.

Os destinatários precisam ser membros da empresa ou registros da tabela Contatos vinculada. Um endereço desconhecido recusa o envio inteiro com recipient_unknown e a orientação para adicioná-lo a Contatos. O envio também pode ser recusado por estar desligado, pelo limite diário ou por supressão, com o motivo unsubscribed, hard_bounce ou complaint. As recusas ficam no histórico. O limite padrão é 200 mensagens por empresa por dia em São Paulo, contando uma por destinatário; a equipe Siglata pode alterá-lo com organization_limits_set({ dailyEmails }).

Só arquivos que a pessoa pode ler são enviados. Até 3 MiB de anexos brutos, os arquivos vão anexados. Acima disso, ou se a mensagem serializada ultrapassar 5 MiB, todos os arquivos vão como links de destinatário válidos por sete dias. Todo e-mail inclui cancelamento de inscrição, também com os cabeçalhos de um clique. Não há pixel de rastreamento.

email_history mostra os próprios envios; donos, administradores e equipe Siglata veem os de toda a empresa. Filtre por recipient, state, since inclusivo e until exclusivo, com datas ISO. limit aceita de 1 a 100, padrão 50; passe continuation para continuar. Cada linha inclui um trecho de até 2.000 caracteres do corpo, os arquivos, reason, o identificador do provedor para conferir entrega e fileOpenedAt, a primeira abertura de um link de arquivo. Passe id para ler o corpo completo de uma única mensagem. Os estados são queued, sent, delivered, bounced, refused e failed.

email_settings_set recebe apenas enabled. Configure contactsTableId e contactsEmailPointer com channel_set, no mesmo vínculo usado pelo WhatsApp. email_suppression_clear recebe address e só pode ser usado pela equipe Siglata.

Supressão de e-mail pelo provedor

Os e-mails dos agentes usam mail.siglata.com. A lista de supressão do provedor de e-mail é compartilhada entre as organizações que usam esse domínio. Por isso, o provedor pode recusar um endereço mesmo quando ele não está na lista de supressão da sua empresa na Siglata.

Quando isso acontece, o envio fica registrado como falha. A mensagem informa que o provedor suprimiu o endereço e que o envio falhou e não foi contado no limite diário da empresa. A supressão da Siglata continua sendo por empresa; removê-la não remove a supressão do provedor.