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

# WhatsApp

> Conversa com o agente Macaly através do WhatsApp

A ligação WhatsApp do Macaly permite-te conversar com o agente Macaly a partir do teu telemóvel. Envia uma mensagem no WhatsApp, recebe uma resposta e continua a trabalhar nos teus projetos sem abrires a app web.

## O que podes fazer

O agente no WhatsApp trabalha nos mesmos projetos que crias na app web. Tudo o que normalmente pedirias ao agente, podes pedir a partir do WhatsApp:

* **Iniciar um novo projeto.** Descreve o que queres criar e o agente põe-se a trabalhar, tal como na app web.
* **Editar os teus projetos existentes.** Pede alterações, correções ou novas secções. Se tiveres vários projetos e não disseres qual, o agente pergunta.
* **Publicar e gerir.** Publica um projeto, muda o seu subdomínio ou verifica o que está em produção.
* **Fazer perguntas rápidas.** Recebe ajuda, ideias ou atualizações de estado sem interromperes o teu fluxo de trabalho.

Quando o agente faz alterações, a resposta chega com um botão **Abrir prévia**, ou **Ver site publicado** quando o projeto já está publicado, para poderes verificar o resultado logo ali.

## O que podes enviar

O agente funciona com tudo o que enviares no WhatsApp:

* **Mensagens de texto.** Basta escrever e enviar.
* **Mensagens de voz.** O Macaly transcreve-as e responde. Útil quando escrever não é prático.
* **Imagens.** Envia capturas de ecrã, mockups ou referências que o agente deve analisar.
* **Ficheiros.** PDFs e documentos que o agente pode ler e usar.

Vídeos não são suportados.

## Como configurar

<Steps>
  <Step title="Abre as definições de Ligações">
    No Macaly, vai a **Definições → Ligações** e clica em **Ligar** no cartão do WhatsApp.

    <img src="https://mintcdn.com/macaly-41b1d3e9/dOzNT7eRKWZWpaZK/images/integrations_whatsapp_01.png?fit=max&auto=format&n=dOzNT7eRKWZWpaZK&q=85&s=ea421781998d6bf5204a4bf53fe105bc" alt="Cartão do WhatsApp nas definições de Ligações" width="2400" height="1600" data-path="images/integrations_whatsapp_01.png" />
  </Step>

  <Step title="Abre o WhatsApp">
    O Macaly mostra um código QR e um link de ligação. Digitaliza o código QR com o teu telemóvel, ou clica em **Abrir WhatsApp** para o abrires no teu computador ou telemóvel com a mensagem de ligação já preenchida.
  </Step>

  <Step title="Envia a mensagem de ligação">
    Envia a mensagem `start [CODE]` já preenchida para o Macaly. Se digitalizaste o código QR, escreve-a e envia-a a partir do teu telemóvel.
  </Step>

  <Step title="Começa a conversar">
    O Macaly confirma a ligação e mostra a conta a que está associada. Podes agora enviar mensagens ao agente a qualquer momento a partir do WhatsApp.
  </Step>
</Steps>

O código de ligação é válido durante 15 minutos. Se expirar, gera um novo a partir das definições de Ligações.

## Comandos do bot

Envia qualquer um destes comandos no teu chat do WhatsApp com o Macaly:

| Comando | O que faz |
| - | - |
| `/new` | Inicia uma nova conversa com o agente. |
| `/switch` | Muda para outro espaço de trabalho ligado (aparece quando há mais de um associado). |
| `/status` | Verifica o estado da tua ligação e do chat atual. |
| `/unlink` | Desliga um espaço de trabalho deste chat. Se houver vários ligados, escolhes qual. |
| `/help` | Lista os comandos disponíveis. |

## Usar vários espaços de trabalho

Podes ligar o mesmo número de WhatsApp a um máximo de 3 espaços de trabalho Macaly. É útil se trabalhas em vários espaços de trabalho e queres alcançá-los todos a partir de um único chat.

* **Ligar outro espaço de trabalho.** Abre **Definições → Ligações** no outro espaço de trabalho e liga-o a partir do mesmo número de WhatsApp.
* **Mudar o espaço de trabalho ativo.** Envia `/switch` e escolhe um espaço de trabalho nos botões. A tua próxima mensagem inicia uma nova conversa aí.
* **Ver qual está ativo.** Envia `/status`, a resposta começa com o nome do espaço de trabalho ativo.

Apenas um espaço de trabalho está ativo de cada vez, por isso as mensagens vão para aquele para o qual mudaste pela última vez. Se desligares o espaço de trabalho ativo, o Macaly muda automaticamente o chat para outro espaço de trabalho ligado, para que continue a funcionar.

## Desligar

Para desligar, envia `/unlink` a partir do WhatsApp, ou abre **Definições → Ligações** na app e remove o número ligado.

Se o chat estiver ligado a apenas um espaço de trabalho, é desligado de imediato. Se houver vários ligados, o `/unlink` pergunta qual remover: desligar um espaço de trabalho que não estás a usar atualmente deixa a tua conversa intacta, e desligar o ativo muda o chat para outro espaço de trabalho ligado.

## Bom saber

* **Sem configuração com a Meta.** Não precisas de uma conta WhatsApp Business nem de chaves API. Basta ligares a partir de Definições e começares a conversar.
* **Os créditos funcionam da mesma forma que na app web.** O trabalho do agente consome créditos à mesma taxa que na app web, mais uma pequena quantia extra quando envias mensagens de voz (para transcrição).
* **Até 3 espaços de trabalho por número de telefone.** Podes associar o teu número de WhatsApp a vários espaços de trabalho Macaly (no máximo 3) e alternar entre eles com `/switch`. Cada membro do espaço de trabalho também pode ligar o seu próprio número.
* **Limite de tamanho das mensagens de voz.** As mensagens de voz podem ter até 10 MB. Gravações mais longas não são enviadas.


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