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

# Plugins

> Conecte serviços externos à sua organização: Google Calendar, Gmail, WhatsApp, Twilio SMS e ClickSign

Os **Plugins** ligam o Kiraa a serviços externos que você já usa. Com eles, você habilita **agendamentos**, **envio de e-mail**, **SMS**, **WhatsApp** e **documentos para assinatura** em toda a plataforma — do agente de IA aos templates, às ações no cliente e às campanhas omnichannel.

Acesse em **Integrações > Plugins**.

## Como funciona a página

* **Catálogo de serviços disponíveis** — abre em **Nova conexão**.
* **Tabela das conexões atuais** — mostra Provedor, Nome, Status (**Ativo**, **Inativo** ou **Erro**), data de conexão e um menu **⋯** com **Testar conexão**, **Editar** e **Remover**.
* **Resumo** no topo — quando você já tem conexões: Total, Ativas e Com erro.

<Info>
  A mesma plataforma pode ter **várias conexões do mesmo serviço** (por exemplo, várias contas Google Calendar ou várias contas Gmail). Cada conexão tem seu próprio **Nome** para você identificar no dia a dia.
</Info>

## Adicionar uma conexão

<Steps>
  <Step title="Abra o catálogo">
    Clique em **Nova conexão**. O diálogo lista todos os serviços disponíveis.
  </Step>

  <Step title="Escolha o serviço">
    Clique em **Conectar** no card do provedor. Alguns abrem um diálogo de credenciais; outros abrem a autenticação do próprio provedor (OAuth).
  </Step>

  <Step title="Confirme">
    Ao terminar, a conexão aparece na tabela como **Ativa** e já fica disponível para usar em templates, ações do cliente, campanhas e Tools.
  </Step>
</Steps>

<Tip>
  Use **Testar conexão** no menu **⋯** de qualquer linha para verificar se as credenciais continuam válidas. Em caso de erro, a linha fica marcada como **Erro** e você pode clicar em **Editar** para corrigir.
</Tip>

***

## Google Calendar

Conecta uma **conta Google** para ler e escrever eventos. É o plugin que habilita a [Tool de Agendamento](/tools) e o fluxo de agendamento usado pelo agente durante a ligação.

* **Como conectar** — clique em **Conectar** e autorize a conta Google no fluxo oficial do provedor.
* **Várias contas** — cada **Nova conexão** pode ser uma conta Google diferente. É exatamente assim que você liga **várias agendas** (por exemplo, uma agenda por profissional em uma clínica): conecte uma conta por pessoa e selecione a conta certa em cada **Agenda** da Tool de Agendamento.
* **Calendários** — dentro de cada conta, você pode usar o calendário **principal** ou qualquer calendário secundário da agenda.
* **Uso na plataforma** — disponibilidade, criação, **reagendamento** e **cancelamento** de eventos durante a conversa com o agente.

<Tip>
  Dê um **Nome** claro para cada conexão (ex: `Google — Dra. Ana`) para facilitar a escolha na hora de configurar a Tool de Agendamento.
</Tip>

***

## Gmail

Permite que o Kiraa **envie e-mails** em nome da conta conectada. Uma vez conectado, o Gmail passa a aparecer como remetente nos fluxos de e-mail da plataforma.

* **Como conectar** — clique em **Conectar** e autorize a conta Google no fluxo oficial do provedor.
* **Várias contas** — você pode ter várias conexões, uma por caixa de e-mail.
* **Uso na plataforma**:
  * **Envio de e-mail no cliente** — botão **E-mail** na ficha do cliente (ver [Clientes](/clients)).
  * **Campanhas de E-mail** — pré-requisito para criar campanhas de e-mail em lote (ver [Campanhas](/campaigns)).
  * **Templates de E-mail** — criação e preview em [Templates de E-mail](/templates-email).

***

## WhatsApp

Envio de mensagens por WhatsApp usando **API não oficial**. É o plugin mais sensível: por isso ele tem **limite** e passos específicos.

* **Como conectar** — clique em **Conectar** no card **WhatsApp**, dê um **Nome** para a integração e confirme. A plataforma mostra um **QR Code** para você pareá-lo no aplicativo do WhatsApp em **Aparelhos Conectados > Conectar Aparelho**.
* **Limite** — até **3 números** conectados por organização. Quando o limite é atingido, o card fica como **Limite atingido** no catálogo.
* **Opções extras** — caso o QR expire, você pode **Gerar novo QR** ou usar **Código de pareamento**.

<Warning>
  Esta integração utiliza **API não oficial**. Trate-a como uma conexão sujeita a variações do próprio WhatsApp — se a sessão cair, reconecte pelo menu **⋯ > Testar conexão** ou **Editar**.
</Warning>

* **Uso na plataforma**:
  * **Envio de WhatsApp no cliente** — botão **WhatsApp** na ficha do cliente.
  * **Campanhas de WhatsApp** — pré-requisito para campanhas em lote.
  * **Templates de WhatsApp** — mensagens com campos dinâmicos e mídia opcional (ver [Templates de WhatsApp](/templates-whatsapp)).
  * **Envio de documentos via WhatsApp** — quando você gera um documento no cliente.

***

## Twilio SMS

Conecta sua conta **Twilio** para enviar SMS a partir da plataforma.

* **Como conectar** — clique em **Conectar Twilio SMS**, preencha:

| Campo                     | Descrição                                                                   |
| ------------------------- | --------------------------------------------------------------------------- |
| **Account SID**           | Identificador da conta Twilio                                               |
| **Auth Token**            | Token secreto da conta (não é mostrado depois)                              |
| **Tipo de remetente**     | **Número de envio (From)** ou **Messaging Service SID**                     |
| **Número de envio**       | Obrigatório se o tipo for **From**, em formato E.164 (ex: `+5511999999999`) |
| **Messaging Service SID** | Obrigatório se o tipo for **Messaging Service**, começando com `MG…`        |

<Tip>
  Para operar com volumes maiores, o **Messaging Service SID** costuma ser a melhor opção na Twilio — ele distribui automaticamente entre números e aplica regras de envio.
</Tip>

* **Uso na plataforma**:
  * **Envio de SMS no cliente** — botão **SMS** na ficha do cliente.
  * **Campanhas de SMS** — pré-requisito para campanhas em lote.
  * **Templates de SMS** — preview com contagem de caracteres e segmentos (ver [Templates de SMS](/templates-sms)).

***

## ClickSign

Conecta o **ClickSign** para enviar documentos gerados pela plataforma para **assinatura**.

* **Como conectar** — clique em **Conectar**, informe:

| Campo                             | Descrição                                                                                     |
| --------------------------------- | --------------------------------------------------------------------------------------------- |
| **Nome da integração**            | Como a conexão aparece na lista                                                               |
| **Access Token**                  | Token gerado no painel do ClickSign                                                           |
| **Ambiente**                      | **Produção** ou **Sandbox (testes)**                                                          |
| **Signatários padrão da empresa** | Lista opcional de pessoas fixas da empresa que assinam os documentos (nome completo e e-mail) |

<Tip>
  Preencher **signatários padrão** evita retrabalho: na hora de enviar um documento para assinatura, eles já aparecem marcados automaticamente.
</Tip>

* **Uso na plataforma** — na ficha do cliente, ao **Gerar documento**, a aba **Assinatura** permite enviar o documento diretamente para o ClickSign, escolhendo signatários do cliente, signatários adicionais e signatários padrão da empresa.

***

## Editar, testar ou remover uma conexão

No menu **⋯** de cada linha da tabela você pode:

* **Testar conexão** — verifica se as credenciais seguem válidas.
* **Editar** — atualiza nome, tokens ou opções do provedor.
* **Remover** — desconecta o serviço. Recursos que dependem dele (templates, campanhas, agendas) precisam ser reconfigurados.

<Warning>
  Remover uma conexão usada por **campanhas ativas**, **Tool de Agendamento** ou **templates** pode interromper o funcionamento desses recursos. Verifique antes se há envios ou agendamentos em andamento.
</Warning>

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Tool de Agendamento" icon="calendar-check" href="/tools">
    Use as contas do Google Calendar conectadas para agendar compromissos com o agente.
  </Card>

  <Card title="Templates" icon="file-pen" href="/files">
    Crie templates de e-mail, SMS, WhatsApp e documentos com campos dinâmicos.
  </Card>

  <Card title="Campanhas" icon="bullhorn" href="/campaigns">
    Dispare em lote por Voz, E-mail, SMS ou WhatsApp usando os plugins conectados.
  </Card>

  <Card title="Clientes" icon="users" href="/clients">
    Use os plugins para enviar mensagens e gerar documentos direto da ficha do cliente.
  </Card>
</CardGroup>