> ## 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.

# WhatsApp via Twilio

> Conecte sua conta Twilio para que o Marcus dispare mensagens de WhatsApp em escala em seu nome.

## Por que Twilio

O Apollo Space usa **Twilio** como provedor de WhatsApp Business porque é a
opção mais estável + auditável do mercado: aprovação Meta, templates
oficiais, status callbacks, suporte a múltiplos números na mesma org.

A integração é **BYO key** (Bring Your Own Key) — você cria a conta
Twilio e fica dono dela. O Apollo Space só **dispara mensagens** via sua
conta; a fatura real do WhatsApp vai pra você direto.

## O que você precisa pra começar

<CardGroup cols={2}>
  <Card title="Conta Twilio" icon="user-tie">
    Crie em [twilio.com](https://twilio.com). Plano pay-as-you-go é
    suficiente — não precisa de plano enterprise.
  </Card>

  <Card title="Número WhatsApp aprovado" icon="phone">
    Aprovação feita pela Meta (Business). O Twilio cobre o processo
    end-to-end — pode levar de 2 a 7 dias úteis dependendo do tipo de
    negócio.
  </Card>

  <Card title="Messaging Service no Twilio" icon="paper-plane">
    Crie um Messaging Service que agrupa: número aprovado, webhook de
    inbound, status callback, e (opcionalmente) templates pré-aprovados.
  </Card>

  <Card title="Credenciais" icon="key">
    Account SID + Auth Token + Messaging Service SID — três strings
    que você cola no Apollo Space (Settings → Integrações → WhatsApp).
  </Card>
</CardGroup>

## Como funciona o envio

Quando o [Marcus](/agents/marcus) dispara uma mensagem:

<Steps>
  <Step title="Apollo Space monta a chamada">
    O agente compõe a mensagem com a voz da sua org, escolhe template
    aprovado (quando fora da janela 24h) ou texto livre (quando dentro).
  </Step>

  <Step title="Apollo Space chama o Twilio">
    Via Messaging Service SID — o Twilio escolhe o número remetente
    do pool configurado.
  </Step>

  <Step title="Twilio entrega via Meta">
    O Twilio é quem realmente fala com a infra do WhatsApp. Apollo Space só
    recebe o ID da mensagem + status inicial.
  </Step>

  <Step title="Tracking inbound (replies)">
    Quando alguém responde, o Twilio chama um webhook do Apollo Space. O
    reply vira atividade no lead + notificação no chat do dono da
    relação. **Marcus não responde sozinho** — quem responde é humano
    (ou o [Twin](/agents/digital-twins) configurado).
  </Step>
</Steps>

## Janela 24h do WhatsApp

A Meta tem uma regra rígida: depois que **o cliente** manda uma
mensagem pra você, abre uma **janela de 24h** durante a qual você
pode responder com **texto livre**. Fora dessa janela, qualquer
primeira mensagem precisa ser um **template aprovado** pela Meta.

O Marcus respeita isso automaticamente:

* Dentro da janela → texto livre, com a voz da org
* Fora da janela → usa o template mais adequado ao contexto, pré-cadastrado
  no seu Messaging Service do Twilio

## Modos de operação

<CardGroup cols={2}>
  <Card title="Self (default)" icon="user">
    Você usa seu próprio número + sua conta Twilio. **Fatura inteira é
    sua** (Twilio cobra você direto). Esta é a opção recomendada para
    qualquer time sério — controle total + zero intermediário.
  </Card>

  <Card title="Shared (pool Apollo Space)" icon="users">
    Em desenvolvimento. Será uma opção pra times pequenos testarem o
    produto sem aprovar número próprio. Quotas mensais reduzidas;
    apropriado pra exploração inicial, não pra operação real.
  </Card>
</CardGroup>

## Custos

| Onde cai                                                             | Quem paga                            |
| -------------------------------------------------------------------- | ------------------------------------ |
| **Mensagem enviada** (preço Meta por conversação)                    | Sua conta Twilio                     |
| **Uso da plataforma Apollo Space** (orquestração, agentes, tracking) | Seu saldo de [Stars](/billing/stars) |

A política de preço da Meta varia por país + categoria da conversa
(marketing, utility, authentication, service). Consulte a tabela
atual da Twilio. O Apollo Space nunca toma nenhuma fração do que você paga
ao Twilio.

## Setup passo-a-passo

Veja [Configurar WhatsApp](/guides/set-up-whatsapp) para o guia
completo com screenshots + diagnóstico de erros comuns.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Marcus — quem usa o canal" icon="paper-plane" href="/agents/marcus">
    O agente outbound dispara via WhatsApp quando o canal está
    conectado.
  </Card>

  <Card title="Guia passo-a-passo" icon="book" href="/guides/set-up-whatsapp">
    Detalhe da configuração + troubleshooting.
  </Card>

  <Card title="Stars" icon="star" href="/billing/stars">
    Como o uso do Apollo Space + o uso do Twilio se dividem no faturamento.
  </Card>
</CardGroup>