---
title: Conectar Shippo para envio
description: Adicione uma chave de API Shippo, confirme a conexão e desconecte Shippo com segurança.
---

Conecte Shippo quando quiser que o Runner use sua conta Shippo para envio e
cumprimento. A conexão usa uma chave de API fornecida pelo Shippo.

## Antes de começar

**Caminho de entrada:** **Projeto → Aplicativos → Aplicativos de loja → Shippo**

Você precisa de:

- uma conta Shippo e uma chave de API Shippo atual;
- autoridade para conectar essa conta ao espaço de trabalho Runner; e
- consciência de que desconectar Shippo remove sua chave e a desativa para todos os projetos no
  espaço de trabalho.

Não cole a chave de API em chat ou documentação.

## Controles e resultados Shippo

| Controle | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| **Conectar** | Abre a configuração Shippo. | O Runner solicita **Chave de API Shippo**. |
| **Chave de API Shippo** | Identifica sua conta Shippo. | O Runner verifica o formato da chave e mostra um erro enquanto o valor é inválido. |
| Ícone de olho | Permite inspecionar o valor para erros de digitação. | Alterna o campo entre texto oculto e visível. Oculte-o novamente antes de compartilhar sua tela. |
| Diálogo **Conectar** | Envia a chave. | Em caso de sucesso, o Runner fecha o diálogo, limpa o campo e altera o cartão para conectado. |
| **Cancelar** ou fechar | Sai da configuração sem enviar. | O Runner limpa a chave inserida do diálogo. |
| Excluir ou **Desconectar** | Inicia a remoção. | O Runner abre **Desconectar Shippo?** com o impacto em todo o espaço de trabalho. |
| Confirmação **Desconectar** | Remove a conexão salva. | O Runner remove a chave de API e desativa Shippo para todos os projetos do espaço de trabalho. |

## Conectar Shippo

1. Abra **Projeto → Aplicativos**.
2. Encontre **Shippo** e selecione **Conectar**.
3. Copie a chave de API da conta Shippo que você pretende usar.
4. Cole-a em **Chave de API Shippo**.
5. Se o Runner relatar uma chave inválida, retorne ao Shippo e copie-a novamente em vez de editar
   o segredo por adivinhação.
6. Selecione **Conectar** no diálogo.
7. Aguarde a mensagem de sucesso e confirme que o cartão mostra seu controle de desconexão conectado.
8. Use dados de teste seguro para verificar o fluxo de envio antes de confiar nele para pedidos de clientes.

## Desconectar ou substituir a chave

Selecione o controle de desconexão do cartão e leia **Desconectar Shippo?**. Confirme apenas quando for
aceitável remover a chave e desativar Shippo para cada projeto no espaço de trabalho.

Para usar uma chave diferente, desconecte a integração atual, confirme que o cartão não está mais conectado,
depois conclua o fluxo de conexão com a chave de substituição.

## Se Shippo não se conectar

- **Chave de API inválida** significa que o valor não corresponde ao formato de chave Shippo aceito.
- **Falha ao conectar Shippo** significa que o Runner não terminou a conexão do provedor. Mantenha
  a chave privada, confirme que está atual em Shippo e tente novamente no cartão.
- Se o diálogo fechar mas o cartão não se conectar, atualize os aplicativos antes de enviar novamente.
- Se a desconexão falhar, assuma que a chave existente ainda está ativa.
- Um cartão conectado não prova que taxas, rótulos, transportadoras ou um envio específico
  funcionam. Verifique essas operações separadamente com dados de teste seguro.

## Guias relacionados

- [Conectar, gerenciar e reconectar um aplicativo](./connect-manage-reconnect)
- [Conectar cumprimento 4PX](./4px-fulfillment)
- [Solucionar problemas de conexão de um aplicativo](./troubleshooting)