---
title: "E-mail da empresa"
description: "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 [#email-provider-suppression]

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.