Como Comecar

Comece a usar o TapSign em poucos minutos. Este guia vai te ajudar a configurar sua conta e enviar seu primeiro documento para assinatura digital.

1. Crie sua conta

Acesse tapsign.com.br e crie sua conta gratuitamente:

1. Clique em Criar conta
2. Preencha seu nome, email e senha
3. Confirme seu email clicando no link enviado
4. Pronto! Voce ja pode comecar a usar o TapSign

Dica

Voce tambem pode se cadastrar usando sua conta Google para agilizar o processo.

2. Obtenha seu token de API

Para fazer requisicoes a API, voce precisa de um token de autenticacao:

1. Acesse Configuracoes > API no painel do TapSign
2. Clique em Gerar Nova Chave
3. Copie a chave gerada (formato tsk_live_*)

Importante

Nao compartilhe seu token com pessoas fora da sua organizacao! A chave de API so e exibida uma vez no momento da criacao. Armazene-a em local seguro.

Testando seu token

Configure o token no header Authorization de todas as requisicoes:

curl -X GET https://api.tapsign.com.br/v1/envelopes \
  -H "Authorization: Bearer tsk_live_abc123def456"

Token Dinamico

Voce tambem pode usar tokens JWT para autenticacao dinamica. Consulte a pagina de Autenticacao para detalhes.

3. Envie seu primeiro documento

Via plataforma

1. No painel principal, clique em Novo Envelope
2. Faca upload do documento (PDF ou DOCX)
3. Adicione um nome ao envelope para facilitar a identificacao

Via API

# 1. Faca upload do documento
curl -X POST https://api.tapsign.com.br/v1/documents \
  -H "Authorization: Bearer tsk_live_abc123def456" \
  -F "file=@contrato.pdf" \
  -F "name=Contrato de Prestacao de Servicos"

# 2. Crie o envelope com o documento
curl -X POST https://api.tapsign.com.br/v1/envelopes \
  -H "Authorization: Bearer tsk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Contrato de Locacao",
    "documents": ["doc_abc123"],
    "signers": [
      {
        "name": "Joao Silva",
        "email": "joao@email.com",
        "role": "SIGNER"
      }
    ]
  }'

# 3. Envie para assinatura
curl -X POST https://api.tapsign.com.br/v1/envelopes/env_abc123/send \
  -H "Authorization: Bearer tsk_live_abc123def456"

4. Acompanhe o status

Acompanhe o progresso da assinatura em tempo real:

Status	Descricao
DRAFT	Rascunho — envelope criado mas nao enviado
SENT	Enviado — notificacoes enviadas aos signatarios
IN_PROGRESS	Em andamento — pelo menos um signatario ja assinou
COMPLETED	Concluido — todos os signatarios assinaram
DECLINED	Recusado — um signatario recusou a assinatura
EXPIRED	Expirado — o prazo para assinatura expirou
CANCELED	Cancelado — o remetente cancelou o envelope

Webhooks

Em vez de consultar o status periodicamente, configure webhooks para receber notificacoes automaticas quando eventos acontecerem.

5. Proximos passos

Secao	Descricao
Ambiente de Testes	Teste sua integracao sem afetar dados reais
Autenticacao	Metodos de autenticacao (API Key e JWT)
Documentos	Crie documentos via API
Modelos	Templates reutilizaveis com variaveis
Webhooks	Notificacoes em tempo real
Organizacoes	Gerencie equipes e permissoes