> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apollospace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Marcus — o outbound

> Escreve e dispara campanhas de e-mail e WhatsApp em sequência, aterrissando no inbox real do destinatário.

## Para que serve

O **Marcus** é o agente que **executa o outbound** — quando você
precisa **falar** com leads em escala mas com qualidade individual,
o Marcus é quem opera.

Ele combina:

* **Pesquisa do lead** (via Scout sob o capô)
* **Composição da mensagem** com a voz do seu time
* **Envio real** via WhatsApp (Twilio) ou e-mail (Resend)
* **Tracking de resposta** e roteamento de inbound

Não é o agente certo pra:

* Pesquisa pura sem ação (Scout)
* Operação do CRM em geral (Athena)
* Conversa pós-resposta com o cliente — esse momento passa pro humano
  (ou pro Twin do dono da relação)

## Fluxo de campanha

<Steps>
  <Step title="Definir a audiência">
    Você seleciona um conjunto de leads (filtro no CRM, lista
    importada, pipeline inteiro). O Marcus opera **por lead** — não
    blasta texto idêntico.
  </Step>

  <Step title="Signal gather">
    Para cada lead, o Marcus chama o Scout (via Tavily) buscando
    sinais públicos: post recente, contratação, prêmio, mudança de
    cargo. Cita pelo menos 3 snippets antes de compor.
  </Step>

  <Step title="Compose (draft)">
    Com os sinais + voz da org + persona do destinatário, o Marcus
    gera o rascunho da mensagem. Aqui já decide:

    * canal (e-mail vs WhatsApp — baseado no que está disponível)
    * tom (formal vs casual — segue o `voice_md` da org)
    * call-to-action (pedir reply, marcar call, mandar link)
  </Step>

  <Step title="HITL — aprovação humana (opcional)">
    Por default cada draft fica em `status='pending'` e aparece num
    card "aguardando aprovação" no chat. Você revisa, edita
    livremente, aprova **ou** rejeita.

    Configurações alternativas:

    * **Auto-approve** para campanhas baixo-risco (newsletter, evento
      público) — Marcus dispara direto
    * **Approve-by-batch** — aprovar todos os drafts de uma run de
      uma vez (depois de spot-check de 3-5)
  </Step>

  <Step title="Envio">
    Após aprovação, Marcus dispara via o canal configurado:

    * **WhatsApp** — via sua conta Twilio (BYO key)
    * **E-mail** — via Resend ou Gmail (Composio), conforme você
      conectou

    Cada envio é idempotente (retries não duplicam mensagem).
  </Step>

  <Step title="Tracking + follow-up">
    Marcus monitora as respostas:

    * **Reply detectado** → roteia pro chat do dono da relação
    * **No-reply em N dias** → dispara o próximo toque da cadência
    * **Bounce / opt-out** → marca lead como inválido + para sequência
  </Step>
</Steps>

## HITL — quando o agente espera

Default: **toda** mensagem outbound passa por aprovação. Você vê o
card no chat com:

* Texto da mensagem renderizado
* Sinais citados (Tavily snippets que motivaram a composição)
* Custo previsto em Stars
* Botões **Aprovar / Editar / Rejeitar**

<Tip>
  Pra times que querem velocidade depois de calibrar a voz: você pode
  **aprovar uma run inteira por amostragem** — abre 5 drafts
  aleatórios da run, se todos OK aprova o batch.
</Tip>

## Personalização pela voz da org

O Marcus carrega o **`voice_md`** da sua organização — um documento
markdown que descreve:

* Como o time apresenta a empresa (nome curto, tagline, USP em 1 linha)
* Como cumprimenta (formal "prezado" vs casual "olá")
* Vocabulário a evitar ("inovador", "disruptivo", etc.)
* Assinatura padrão
* Política de tom em cada canal (WhatsApp pode ser mais informal que
  e-mail)

Esse documento é **editável pelo time** — fica versionado e cada
mudança é audited. Marcus relê em todo run.

## Tracking de inbound

Quando um destinatário responde:

| Canal                               | Como Marcus detecta                                                         |
| ----------------------------------- | --------------------------------------------------------------------------- |
| **E-mail**                          | Webhook do provedor de e-mail aciona o tracking automático                  |
| **WhatsApp**                        | Webhook do provedor de mensageria aciona o tracking automático              |
| **Reply manual fora da plataforma** | Marcus NÃO captura — o humano precisa marcar a atividade no CRM manualmente |

A resposta vira uma **atividade no lead** + **notificação no chat** do
dono da relação. Marcus **NÃO responde** o reply — quem responde é o
humano (ou o [Twin](/agents/digital-twins) dele).

## Cadência

Você define a cadência por campanha — quantos toques, em que canal, com
qual espaçamento. Os defaults sugeridos pra outbound B2B alternam
e-mail + WhatsApp ao longo de algumas semanas com ângulos diferentes
em cada toque.

A cadência **respeita a janela de 24h do WhatsApp** automaticamente —
fora dela, Marcus usa template aprovado pela Meta em vez de free-form.

## Métricas que Marcus expõe

Por campanha + por toque:

* **Delivery rate** (entregue / disparado)
* **Open rate** (e-mail só — WhatsApp não tem read receipt confiável)
* **Reply rate**
* **Reply-to-CTA rate** (resposta que aceita a chamada-pra-ação)
* **Opt-out / bounce rate**
* **Custo total da campanha** em Stars

## Próximos passos

<CardGroup cols={2}>
  <Card title="WhatsApp setup" icon="comments" href="/guides/set-up-whatsapp">
    Conectar sua conta Twilio + número aprovado.
  </Card>

  <Card title="Outbound feature" icon="paper-plane" href="/features/outbound">
    Detalhe das sequências + tipos de campanha.
  </Card>

  <Card title="Scout — pesquisa por trás" icon="binoculars" href="/agents/scout">
    O Marcus chama o Scout pra cada lead. Entenda como.
  </Card>

  <Card title="Custos do outbound" icon="star" href="/billing/stars">
    Quanto cada toque WhatsApp / e-mail debita do wallet.
  </Card>
</CardGroup>