

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Palavras-chave em SMS de mensagens para usuários AWS finais
<a name="keywords"></a>

Uma *palavra-chave* é uma palavra ou frase específica que o cliente pode enviar ao seu número de telefone para obter uma resposta, como uma mensagem informativa, assinar para receber mais mensagens, uma oferta especial e outras mensagens promocionais e transacionais. Quando seu número recebe uma mensagem que começa com uma palavra-chave, o SMS do AWS End User Messaging responde com uma mensagem personalizável.

Para códigos curtos, o console mostra as palavras-chave e as respostas que você define inicialmente ao solicitar um código curto Suporte. Suporte registra suas palavras-chave e respostas com operadoras de telefonia móvel ao fornecer seu código curto.

Para códigos longos, o console mostra as palavras-chave e respostas padrão.

**Importante**  
Suas palavras-chave e mensagens de resposta devem estar em conformidade com as diretrizes definidas pelas operadoras sem fio e grupos do setor sem fio. Do contrário, após auditoria, esses grupos podem tomar medidas contra seu código curto ou longo. Essa ação pode incluir seu número na lista de rejeição e bloquear suas mensagens.

Uma palavra-chave pode ter entre 1 e 30 caracteres e não pode começar ou terminar com um espaço. Palavras-chave diferenciam maiúsculas de minúsculas.

Para agentes do AWS RCS, as palavras-chave são configuradas no AWS RCS Agent e se aplicam a todos os RCS for Business associados IDs (agente de teste e agentes de lançamento do país). Quando um usuário final envia uma mensagem contendo uma palavra-chave para seu AWS RCS Agent, o AWS End User Messaging SMS responde com a resposta de palavra-chave configurada. Para obter mais informações sobre o recebimento de mensagens RCS de entrada e o tratamento de palavras-chave, consulte. [Recebendo mensagens RCS de entrada](rcs-inbound.md)

As operadoras sem fio nos EUA exigem códigos simplificados para oferecer suporte às palavras-chave a seguir. Além disso, AWS espera que todos os códigos longos e curtos suportem essas palavras-chave:

AJUDA  
Usada para obter suporte ao cliente. A mensagem de resposta deve incluir informações de contato de suporte ao cliente, como no exemplo a seguir:  
*“Para obter assistência com sua conta, ligue para (206) 555-0199”.*

PARAR  
Usada para cancelar o recebimento de mensagens de seu número. Além de *PARAR*, seu público pode usar qualquer palavra-chave de cancelamento, como *CANCELAR* ou *CANCELAR RECEBIMENTO*. Para ver uma lista das palavras-chave de cancelamento compatíveis, consulte [Palavras-chave de exclusão obrigatórias](keywords-required.md). Depois que seu número recebe uma mensagem SMS que contém uma palavra-chave de exclusão, o AWS End User Messaging SMS deixa de enviar mensagens SMS da sua conta para a pessoa que optou por não participar.   
A mensagem de resposta deve confirmar que as mensagens deixarão de ser enviadas à pessoa que optou pelo cancelamento, como no exemplo a seguir:  
*“Agora que você optou pelo cancelamento, não receberá mais mensagens”.*

**Topics**
+ [Palavras-chave de exclusão obrigatórias](keywords-required.md)
+ [Ações de palavras-chave](keywords-actions.md)
+ [Adicionar uma palavra-chave a um número de telefone](keywords-manage-phone-number.md)
+ [Exibir as palavras-chave usadas por um número de telefone](keywords-phone-number-list.md)
+ [Editar uma palavra-chave usada por um número de telefone](keywords-phone-number-edit.md)
+ [Excluir uma palavra-chave de um número de telefone](keywords-phone-number-delete.md)
+ [Adicionar uma palavra-chave a um pool de telefones](keywords-pool-add.md)
+ [Exibir palavras-chave usadas por um pool telefônico](keywords-pool-list.md)
+ [Editar uma palavra-chave em um pool de telefones](keywords-pool-edit.md)
+ [Excluir uma palavra-chave de um pool telefônico](keywords-pool-delete.md)

# Palavras-chave de exclusão obrigatórias
<a name="keywords-required"></a>

Quando exigido por leis e regulamentos locais (como nos EUA e no Canadá), os destinatários de SMS e MMS podem usar seus dispositivos para cancelar o recebimento respondendo à mensagem com uma destas opções: 

**nota**  
Você pode adicionar palavras-chave personalizadas aos números de telefone e grupos telefônicos para optar por não participar.
+ ARRET
+ CANCEL
+ END
+ CANCELAR
+ CANCELAR
+ QUIT
+ REMOVE
+ STOP
+ TD
+ CANCELAR INSCRIÇÃO

Para optar por não participar, o destinatário deve responder ao mesmo número de telefone que o SMS de mensagem do usuário AWS final usou para entregar a mensagem. Depois de cancelar, o destinatário não recebe mais mensagens SMS ou MMS da sua AWS conta.

**nota**  
Para números de ligação gratuita dos EUA, opções de cancelamento são gerenciados pela operadora. A única palavra-chave de cancelamento compatível com números gratuitos dos EUA é STOP. Você não pode adicionar outras palavras-chave de cancelamento nem alterar a mensagem de resposta que seus destinatários recebem quando optam por não participar. Um usuário pode se inscrever novamente enviando uma nova mensagem para a ligação gratuita usando UNSTOP ou START como palavra-chave.  
Para configurar a permissão de um usuário se inscrever novamente, adicione as palavras-chave UNSTOP, START ou ambas ao seu número gratuito e defina a ação da palavra-chave como `Opt-in`.

# Ações de palavras-chave
<a name="keywords-actions"></a>

Uma palavra-chave pode ter uma das três ações associadas a ela. Quando um cliente responde com a palavra-chave, a ação será executada para adicionar ou remover o usuário da lista de exclusão ou responder ao usuário com uma mensagem.
+ `Opt-out`— O destinatário é adicionado à lista de opt-out e não receberá mensagens futuras.
+ `Opt-in`— O destinatário deseja receber mensagens futuras.
+ `Automatic response` Uma mensagem é enviada ao destinatário que envia a mensagem de texto com a palavra-chave.

# Adicionar uma palavra-chave a um número de telefone no AWS End User Messaging SMS
<a name="keywords-manage-phone-number"></a>

Use o console do AWS End User Messaging SMS ou AWS CLI para personalizar as respostas de palavras-chave do seu número de telefone.

------
#### [ Add a keyword (Console) ]

Use o console do AWS End User Messaging SMS para adicionar palavras-chave ao seu número de telefone. 

**Adicionar uma palavra-chave**

1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. No painel de navegação, em **Configurações**, selecione **Número de telefone**.

1. Na página **Número de telefone**, selecione o número de telefone ao qual adicionar uma palavra-chave.

1. Na guia **Palavras-chave**, selecione o botão **Adicionar palavra-chave**.

1. No painel **Palavra-chave personalizada**, adicione o seguinte:
   + **Palavra-chave** – a nova palavra-chave a ser adicionada.
   + **Mensagem de resposta**: a mensagem a ser enviada de volta ao destinatário.
   + **Ação de palavra-chave**: a ação a ser executada quando a palavra-chave é recebida.

1. Selecione **Adicionar palavra-chave**.

------
#### [ Add or edit a keyword (AWS CLI) ]

Você pode usar o comando [put-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-keyword.html) para criar uma nova palavra-chave ou editar uma existente. Se a palavra-chave já existir, ela será substituída.

Para criar uma palavra-chave, execute o comando a seguir na AWS CLI:

```
$ aws pinpoint-sms-voice-v2 put-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword \
> --keyword-message KeywordMessage \
> --keyword-action KeywordAction
```

No comando anterior, faça as seguintes alterações:
+ Substitua *OriginationIdentity* pelo ID exclusivo ou nome do recurso da Amazon (ARN) do número de telefone que você deseja adicionar a palavra-chave.
+ Substitua *Keyword* pela nova palavra-chave.
+ Substitua *KeywordMessage* pela mensagem a ser usada ao responder à palavra-chave.
+ Substitua *KeywordAction* pela ação (`AUTOMATIC_RESPONSE`, `OPT_OUT`, `OPT_IN`) a ser executada quando a palavra-chave for recebida.

------

# Visualize as palavras-chave usadas por um número de telefone no AWS End User Messaging SMS
<a name="keywords-phone-number-list"></a>

Você pode usar o comando [describe-keywords](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-keywords.html) para exibir informações sobre palavras-chave associadas a uma identidade de origem.

Para visualizar uma lista de palavras-chave usando a AWS CLI, na linha de comando, digite o seguinte:

```
$ aws pinpoint-sms-voice-v2 describe-keywords \
> --origination-identity OriginationIdentity
```

No comando anterior, faça as seguintes alterações:

Substitua *OriginationIdentity* pelo ID exclusivo ou nome do recurso da Amazon (ARN) do número de telefone ou ID do remetente do qual deseja extrair uma lista de palavras-chave.

# Editar uma palavra-chave usada por um número de telefone no AWS End User Messaging SMS
<a name="keywords-phone-number-edit"></a>

Use o console do AWS End User Messaging SMS ou AWS CLI para editar respostas de palavras-chave para seu número de telefone.

------
#### [ Edit a keyword (Console) ]

Use o console do AWS End User Messaging SMS para editar palavras-chave. 

**Para editar uma palavra-chave**

1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. No painel de navegação, em **Configurações**, selecione **Número de telefone**.

1. Na página **Números de telefone**, selecione o número de telefone ao qual adicionar uma palavra-chave.

1. Na guia **Palavras-chave**, escolha a palavra-chave a ser editada e, em seguida, o botão **Editar palavra-chave**.

1. No painel **Palavra-chave personalizada**, modifique qualquer um dos seguintes itens:
   + **Palavra-chave** — A palavra-chave a ser alterada.
   + **Mensagem de resposta**: a mensagem a ser enviada de volta ao destinatário.
   + **Ação de palavra-chave**: a ação a ser executada quando a palavra-chave é recebida.

1. Escolha **Salvar palavra-chave**.

------
#### [ Add or edit a keyword (AWS CLI) ]

Você pode usar o comando [put-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-keyword.html) para criar uma nova palavra-chave ou editar uma existente. Se a palavra-chave já existir, ela será substituída.

Para criar uma palavra-chave, execute o comando a seguir na AWS CLI:

```
$ aws pinpoint-sms-voice-v2 put-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword \
> --keyword-message KeywordMessage \
> --keyword-action KeywordAction
```

No comando anterior, faça as seguintes alterações:
+ Substitua *OriginationIdentity* pelo ID exclusivo ou nome do recurso da Amazon (ARN) do número de telefone que você deseja adicionar a palavra-chave.
+ Substitua *Keyword* pela nova palavra-chave.
+ Substitua *KeywordMessage* pela mensagem a ser usada ao responder à palavra-chave.
+ Substitua *KeywordAction* pela ação (`AUTOMATIC_RESPONSE`, `OPT_OUT`, `OPT_IN`) a ser executada quando a palavra-chave for recebida.

------

# Excluir uma palavra-chave de um número de telefone no AWS End User Messaging SMS
<a name="keywords-phone-number-delete"></a>

Use o console AWS End User Messaging SMS para excluir uma palavra-chave do seu número de telefone.

**nota**  
As palavras-chave de exclusão obrigatórias não podem ser excluídas.

**Excluir uma palavra-chave**

1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. No painel de navegação, em **Configurações**, selecione **Números de telefone**.

1. Na página **Números de telefone**, escolha o número de telefone que contém a palavra-chave.

1. Na guia **Palavras-chave**, escolha a palavra-chave a ser excluída e, em seguida, **Remover palavra-chave**. 

# Adicionar uma palavra-chave a um pool telefônico no AWS End User Messaging SMS
<a name="keywords-pool-add"></a>

Use o console SMS do AWS End User Messaging ou AWS CLI para personalizar as respostas a palavras-chave para seu pool de telefones.

------
#### [ Add a keyword (Console) ]

Use o console AWS End User Messaging SMS para adicionar palavras-chave ao seu pool. 

**Adicionar uma palavra-chave**

1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. No painel de navegação, em **Configurações**, selecione **pools de telefone**.

1. Na página **Phone Pools**, selecione o pool ao qual adicionar uma palavra-chave.

1. Na guia **Palavras-chave**, selecione **Adicionar palavra-chave**.

1. No painel **Palavra-chave personalizada**, faça o seguinte:
   + **Palavra-chave** – a nova palavra-chave a ser adicionada.
   + **Mensagem de resposta**: a mensagem a ser enviada de volta ao destinatário.
   + **Ação de palavra-chave**: a ação a ser executada quando a palavra-chave é recebida.

1. Selecione **Adicionar palavra-chave**.

------
#### [ Add or edit a keyword (AWS CLI) ]

Você pode usar o comando [put-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-keyword.html) para criar uma nova palavra-chave ou editar uma existente. Se a palavra-chave já existir, ela será substituída.

Para criar uma palavra-chave, execute o comando a seguir na AWS CLI:

```
$ aws pinpoint-sms-voice-v2 put-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword \
> --keyword-message KeywordMessage \
> --keyword-action KeywordAction
```

No comando anterior, faça as seguintes alterações:
+ Substitua *OriginationIdentity* pelo ID exclusivo ou nome do recurso da Amazon (ARN) do pool ao qual você deseja adicionar a palavra-chave.
+ Substitua *Keyword* pela nova palavra-chave.
+ Substitua *KeywordMessage* pela mensagem a ser usada ao responder à palavra-chave.
+ Substitua *KeywordAction* pela ação (`AUTOMATIC_RESPONSE`, `OPT_OUT`, `OPT_IN`) a ser executada quando a palavra-chave for recebida.

------

# Exibir palavras-chave usadas por um pool telefônico no AWS End User Messaging SMS
<a name="keywords-pool-list"></a>

Use o console SMS do AWS End User Messaging ou AWS CLI para exibir as respostas de palavras-chave do seu pool telefônico.

------
#### [ View keywords (Console) ]

Use o console AWS End User Messaging SMS para visualizar as palavras-chave do seu pool. 

**Adicionar uma palavra-chave**

1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. No painel de navegação, em **Configurações**, selecione **pools de telefone**.

1. Na página **Phone Pools**, escolha o pool.

1. Na guia **Palavras-chave**, você pode ver a palavra-chave, a mensagem de resposta e as ações.

------
#### [ List keywords (AWS CLI) ]

Você pode usar o comando [describe-keywords](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-keywords.html) para exibir informações sobre palavras-chave associadas a uma identidade de origem.

Para visualizar uma lista de palavras-chave usando a AWS CLI, na linha de comando, digite o seguinte:

```
$ aws pinpoint-sms-voice-v2 describe-keywords \
> --origination-identity OriginationIdentity
```

No comando anterior, faça as seguintes alterações:

Substitua *OriginationIdentity* pelo ID exclusivo ou nome do recurso da Amazon (ARN) do número de telefone ou ID do remetente do qual deseja extrair uma lista de palavras-chave.

------

# Editar uma palavra-chave em um pool de telefones
<a name="keywords-pool-edit"></a>

Use o console SMS do AWS End User Messaging ou AWS CLI para editar respostas de palavras-chave para seu pool telefônico.

------
#### [ Edit a keyword (Console) ]

Use o console AWS End User Messaging SMS para editar palavras-chave em seu pool. 

**Para editar uma palavra-chave**

1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. No painel de navegação, em **Configurações**, selecione **pools de telefone**.

1. Na página **Phone Pools**, escolha o pool que contém a palavra-chave.

1. Na guia **Palavras-chave**, escolha a palavra-chave a ser editada e, em seguida, **Editar palavra-chave**.

1. No painel **Palavra-chave personalizada**, modifique qualquer um dos seguintes itens:
   + **Palavra-chave** — A palavra-chave a ser editada.
   + **Mensagem de resposta**: a mensagem a ser enviada de volta ao destinatário.
   + **Ação de palavra-chave**: a ação a ser executada quando a palavra-chave é recebida.

1. Escolha **Salvar palavra-chave**.

------
#### [ Add or edit a keyword (AWS CLI) ]

Você pode usar o comando [put-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-keyword.html) para criar uma nova palavra-chave ou editar uma existente. Se a palavra-chave já existir, ela será substituída.

Para criar uma palavra-chave, execute o comando a seguir na AWS CLI:

```
$ aws pinpoint-sms-voice-v2 put-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword \
> --keyword-message KeywordMessage \
> --keyword-action KeywordAction
```

No comando anterior, faça as seguintes alterações:
+ Substitua *OriginationIdentity* pelo ID exclusivo ou nome do recurso da Amazon (ARN) do pool ao qual você deseja adicionar a palavra-chave.
+ Substitua *Keyword* pela nova palavra-chave.
+ Substitua *KeywordMessage* pela mensagem a ser usada ao responder à palavra-chave.
+ Substitua *KeywordAction* pela ação (`AUTOMATIC_RESPONSE`, `OPT_OUT`, `OPT_IN`) a ser executada quando a palavra-chave for recebida.

------

# Excluir uma palavra-chave de um pool telefônico no AWS End User Messaging SMS
<a name="keywords-pool-delete"></a>

Use o console AWS End User Messaging SMS ou AWS CLI para excluir uma palavra-chave do seu pool telefônico.

------
#### [ Delete a keyword (Console) ]

Use o console AWS End User Messaging SMS para excluir palavras-chave em seu pool. 

**nota**  
As palavras-chave de exclusão obrigatórias não podem ser excluídas.

**Excluir uma palavra-chave**

1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. No painel de navegação, em **Configurações**, selecione **pools de telefone**.

1. Na página **Phone Pools**, escolha o pool que contém a palavra-chave.

1. Na guia **Palavras-chave**, escolha a palavra-chave e, em seguida, **Remover palavra-chave**. 

------
#### [ Delete a keyword (AWS CLI) ]

Você pode usar a CLI [delete-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-keyword.html) para excluir uma palavra-chave.

Na linha de comando, insira o seguinte comando:

```
$ aws pinpoint-sms-voice-v2 delete-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword
```

No comando anterior, faça as seguintes alterações:
+ Substitua *OriginationIdentity* pelo ID exclusivo ou nome do recurso da Amazon (ARN) do número de telefone ou ID do remetente do qual deseja remover a palavra-chave.
+ Substitua *Keyword* pela palavra-chave a ser excluída.

------