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

# Evento de contato

Saiba mais sobre como gerenciar eventos de contato no YCloud

## Definição de eventos

O rastreamento de eventos no YCloud ajuda você a entender melhor como seus clientes usam seu produto. Essa compreensão permite enviar mensagens direcionadas e relevantes, além de fornecer todo o contexto necessário para oferecer suporte aos seus clientes.

Os eventos representam o que seus clientes fazem e quando o fazem, por exemplo:

* Quando um cliente se cadastra
* Quando um cliente adiciona um item ao carrinho no seu site
* Quando um cliente inicia o processo de checkout
* Quando um cliente conclui um pedido
* Quando um usuário se inscreve em um plano de membros

Os eventos podem ser usados em vários produtos da plataforma YCloud:

* **Gatilho no Journey:** Os eventos podem disparar ações específicas.
* **Interação do cliente no Inbox:** Os eventos permitem que o atendimento ao cliente veja as interações recentes do usuário.
* **Definição do resultado de conversão de CTWA:** Os eventos podem definir resultados de conversão.

**Casos de uso:**

* **Journey:** Assim que um cliente aciona um evento de cobrança, ele entra no fluxo. Após aguardar 20 minutos, uma mensagem de marketing no WhatsApp é enviada para incentivar o cliente a concluir o pagamento. Se o cliente fizer um pedido, ele sairá do fluxo.
* **CTWA:** Quando um cliente realiza um pedido com sucesso, o evento de pedido é registrado como o resultado de conversão para o CTWA, que é então repassado para a plataforma de anúncios.

<Info>
  Os eventos descritos aqui são apenas exemplos; você pode projetá-los de acordo com suas necessidades específicas.
</Info>

## Atributos de eventos:

Cada evento inclui as seguintes informações:

* Nome do evento
* Horário do evento
* Identificador do contato: um ID de contato (`objectId`), número de telefone (`contactPhoneNumber`) ou nome de usuário da Meta (`contactUsername`)

Use um nome de usuário da Meta quando o contato já existir na sua conta e você não tiver o número de telefone dele. Envie o nome de usuário salvo no contato, sem o `@` inicial. Se nenhum contato for compatível, o evento será rejeitado; um nome de usuário não cria um contato automaticamente.

Apenas um identificador é utilizado. Se você enviar vários identificadores, um ID numérico de contato terá precedência, seguido por um número de telefone não vazio e, em seguida, um nome de usuário da Meta.

Cada evento rastreado também pode incluir atributos, que fornecem detalhes adicionais sobre cada evento específico. Por exemplo, se você rastrear um evento de "compra", os metadados podem incluir o nome e o preço do item comprado.

* `STRING`: Uma string simples com até 255 caracteres.
* `NUMBER`: Um valor numérico com até uma casa decimal.
* `TIMESTAMP`: O timestamp do evento.
* `URL`: Uma string formatada como URL, começando com `http://` ou `https://`.

## Criando e enviando eventos

Por padrão, o YCloud rastreia apenas alguns eventos básicos, como a adição de novos contatos à sua lista de Contatos.

Eventos mais valiosos geralmente exigem a ajuda de engenheiros ou desenvolvedores para serem implementados. Compartilhe esta documentação com seus colegas e explique como pretende usá-la.

* **Criar uma definição de evento:** [Abrir a referência da API](/api-reference/custom-events/create-an-event-definition)
* **Enviar um evento:** [Abrir a referência da API](/api-reference/custom-events/send-an-event)
* **Guia de integração:** [Rastrear eventos personalizados](/pt/api-reference/guides/customer-data-and-operations/track-custom-events) para regras de identificadores e exemplos de requisições por número de telefone ou nome de usuário.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.