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

# Aniversário automático

> Envie uma mensagem todo dia para quem está de aniversário.

A automação de aniversário envia, todo dia no horário escolhido, uma mensagem para os contatos que fazem aniversário, **uma vez por ano por contato**.

## Configurar

Em **Contatos › Automações › Nova automação**:

* **Conexão que envia** e o **horário** (6h–22h, horário de Brasília);
* **Para quem**: todos os contatos ou só de uma categoria;
* **Mensagem**, com até 5 variações (`{{primeiro_nome}}` e `{{nome}}` são substituídos) e botões de IA.

O botão **Testar** envia a mensagem para um número de sua escolha, sem afetar a contagem.

## Ter a data de nascimento

O contato precisa da data. Duas formas:

* no **cadastro do contato** (campo "Data de nascimento");
* na **importação de CSV**, com a coluna `dataNascimento` (aceita `AAAA-MM-DD`, `DD/MM/AAAA` ou só `DD/MM`);
* pela **API v1**: `POST /api/v1/contacts` com `dataNascimento` (ou `birthday`).

## Como funciona

* Todo dia, a partir do horário escolhido, a plataforma envia para quem está de aniversário, uma vez por ano.
* Quem pediu para sair (descadastro) não recebe.
* Nascidos em **29 de fevereiro** recebem em 28/02 nos anos não bissextos.
* A automação criada depois do horário de hoje começa amanhã.
* O painel mostra quantos foram enviados no ano, os que falharam e os próximos 7 dias de aniversariantes.

## Onde fica

**Contatos › Automações**. A automação pode ser pausada e retomada a qualquer momento.