> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Trello

Sua recepcionista pode adicionar um cartão a uma lista do Trello quando uma pessoa liga e pede um retorno, um orçamento ou qualquer outra coisa que sua equipe precise acompanhar. Uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks) cria o cartão pela API REST do Trello.

## Antes de começar

### Obtenha uma chave de API

Acesse o [portal de administração do Power-Up](https://trello.com/apps/admin), crie um Power-Up para seu workspace (o nome não importa), abra a aba **Trello Auth** e selecione **Generate a new API key**.

### Gere um token

Selecione o link **Token** ao lado da sua chave de API ou abra esta URL em um navegador com sua chave de API no lugar de `API_KEY`:

```
https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY
```

Selecione **Allow** e copie o token. Ele pode ler e alterar todos os quadros que você pode acessar, então considere gerá-lo com uma conta que seja membro apenas do quadro necessário.

### Encontre o ID da lista

Abra o quadro no navegador, adicione `.json` ao final da URL e carregue a página. Procure o nome da lista; o valor de `id` ao lado dele é o ID da lista.

## Crie a ferramenta de webhook

Vá para **Integrações**, selecione **Adicionar integração** e escolha **Ferramenta de webhook**.

| Campo                         | Valor                                                                                                                                                                                                                                                                            |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                      | `create_trello_card`                                                                                                                                                                                                                                                             |
| **Descrição**                 | "Crie um cartão para a equipe sempre que você prometer à pessoa que ligou um acompanhamento ou quando ela pedir algo que a equipe precisa resolver."                                                                                                                             |
| **Método**                    | POST                                                                                                                                                                                                                                                                             |
| **URL**                       | `https://api.trello.com/1/cards?idList=LIST_ID`                                                                                                                                                                                                                                  |
| **Cabeçalhos da solicitação** | `Authorization`: `OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`                                                                                                                                                                                                       |
| **Parâmetros do corpo**       | `name` (string, obrigatório): "Título curto com o nome da pessoa que ligou e o que ela precisa, por exemplo: Retornar a ligação de Jane Doe sobre um orçamento."  `desc` (string, obrigatório): "O nome, o número de telefone e os detalhes da solicitação da pessoa que ligou." |
| **Atribuir a agentes**        | **Recepcionista**                                                                                                                                                                                                                                                                |

Digite `?idList=LIST_ID` no próprio campo de URL, com o ID da sua lista. Não adicione `idList` como um parâmetro de consulta: os parâmetros de consulta são preenchidos pela IA, enquanto o texto na URL é enviado exatamente como foi escrito.

> **Note**
>
> O Trello também aceita a chave e o token na URL, como `&key=API_KEY&token=TOKEN`. Isso também funciona,
> mas o cabeçalho os mantém fora da URL. Se você colocá-los na URL, trate a URL inteira como um
> segredo.

Selecione **Ativar** e depois [teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) pedindo um retorno. O cartão aparecerá no fim da lista.

## Solução de problemas

| Problema                           | O que verificar                                                                                                                                             |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| O Trello retorna 401               | Verifique o cabeçalho: a chave e o token devem estar entre aspas duplas, separados por uma vírgula e um espaço. Gere o token novamente se ele foi revogado. |
| `invalid value for idList`         | O ID da lista na URL está errado. Use o `id` da lista, não o do quadro.                                                                                     |
| O Trello retorna 404 ou sem acesso | O usuário do token deve ser membro do quadro.                                                                                                               |
| A recepcionista nunca cria cartões | Faça a descrição da ferramenta mencionar as situações em que ela deve criar um cartão.                                                                      |